Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Learn how to use the call delegation APIs to streamline communication workflows into custom applications. These APIs enable querying and managing delegates and delegators to enhance collaborative call scenarios, such as shared line appearances and proxy calling.
Prerequisites
To access these APIs, the following configurations are required:
Permissions: Assign delegated scopes to your application for access. Use the following URL to sign in with an admin account and assign permissions:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={Client-App-ID}&response_type=code&scope=https://graph.microsoft.com/CallDelegation.ReadPolicies: Assign the
AllowDelegationpolicy in Microsoft Teams using PowerShell:Set-CsTeamsCallingPolicy -AllowDelegation $true
Introduction to Teams delegation
Microsoft Teams delegation allows users to share call responsibilities by assigning delegates. Delegates can perform actions such as receiving calls, making calls on behalf of others, and managing call settings. This feature is useful in scenarios where an assistant or team member handles communications for another user.
Microsoft Graph enable developers to programmatically manage delegators and delegates. Common scenarios include:
- Setting up shared line appearances.
- Managing permissions for making and receiving calls.
- Streamlining communication workflows within teams.
Who is a delegator?
A delegator is a user who grants another user (delegate) the ability to perform certain actions on their behalf. These actions can include making and receiving calls, managing call settings, or joining active calls. Delegators are typically users who need assistance in handling their communication responsibilities.
Who is a delegate?
A delegate is a user who is assigned responsibilities by a delegator. Delegates can take specific actions like answering calls, initiating calls, and managing call settings on behalf of the delegator. This role is commonly used by assistants or team members to facilitate seamless communication workflows.
Common use cases
| Operation | Return type | Description |
|---|---|---|
| List all delegates | delegationSettings collection | Get a list of all delegates for a user. |
| Get delegate by ID | delegationSettings | Get details about a specific delegate. |
| List all delegators | delegationSettings collection | Get a list of all delegators for a user. |
| Get delegator by ID | delegationSettings | Get details about a specific delegator. |
Next steps
Use the call delegation API in Microsoft Graph to query and manage delegates and delegators in Teams. To learn more:
- Explore the resources and methods that are most helpful to your scenario.
- Try the API in the Graph Explorer.