check before: 2025-10-10
Product:
Microsoft Graph, Teams
Platform:
Developer, Online, World tenant
Status:
Change type:
Admin impact, New feature, Updated message, User impact
Links:
Details:
Summary:
Microsoft Graph now offers Teams administration APIs: Teams User Configuration API (V1.0), Number Management, and Policy Assignment APIs (beta). These enable automation of user settings, phone number management, and policy assignments for Teams admins. APIs support delegated and application permissions in commercial environments.
Details:
Updated January 20, 2026: We have updated the content. Thank you for your patience.
Microsoft Graph now includes APIs that support Teams administration scenarios through beta:
Teams User Configuration API - Available through V1.0
Number Management APIs - Available through beta
Policy Assignment APIs - Available through beta
These APIs enable programmatic access to user configurations, telephone number management, and policy assignments-helping organizations automate and scale Teams management. They are designed to support extensibility, automation, and integrations with your existing tools and workflows.
[When this will happen:]
Please note that only Teams User Configuration API is currently available via the Microsoft Graph through V1.0, rest of the two APIs (Number Management and Policy Assignment) are currently available via the Microsoft Graph through beta. They are supported in commercial environments and accessible through both delegated and application permissions.
Change Category:
XXXXXXX ... free basic plan only
Scope:
XXXXXXX ... free basic plan only
Release Phase:
Created:
2025-10-10
updated:
2026-01-21
Task Type
XXXXXXX ... free basic plan only
Docu to Check
XXXXXXX ... free basic plan only
MS How does it affect me
XXXXXXX ... free basic plan only
MS Preperations
XXXXXXX ... free basic plan only
MS Urgency
XXXXXXX ... free basic plan only
MS workload name
XXXXXXX ... free basic plan only
summary for non-techies**
XXXXXXX ... free basic plan only
Direct effects for Operations**
API Integration Issues
If the new Teams administration APIs are implemented without proper preparation, there may be integration issues with existing systems, leading to disruptions in user management and policy assignments.
- roles: Teams Admin, IT Support
- references: https://learn.microsoft.com/graph/api/teamsadministration-teamsadminroot-list-userconfigurations?view=graph-rest-1.0, https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta
User Experience Disruption
Without adequate preparation, users may experience disruptions in their Teams functionalities, such as inability to access certain features or incorrect policy applications, negatively impacting their productivity.
- roles: End Users, Teams Admin
- references: https://learn.microsoft.com/graph/api/teamsadministration-telephonenumbermanagementroot-list-numberassignments?view=graph-rest-beta, https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta
Configutation Options**
XXXXXXX ... paid membership only
explanation for non-techies**
Microsoft has introduced new APIs for Teams administration through Microsoft Graph, which are currently available in beta. These APIs are like a set of tools that allow IT administrators to manage various aspects of Microsoft Teams more efficiently. Imagine these APIs as remote controls for your TV. Instead of getting up to change the channel or adjust the volume, you can do it all from the comfort of your couch. Similarly, these APIs allow administrators to manage Teams settings, phone numbers, and policies without manually adjusting each setting for every user.
The Teams User Configuration API is like a detailed user manual for each Teams user. It lets administrators see all the settings and policies applied to a user, much like how you can check the settings on your smartphone to see which apps have permissions to access your location or camera.
The Number Management APIs are akin to a phone book manager. They allow admins to handle telephone numbers within Teams, such as assigning or unassigning numbers to users, similar to how you might manage contacts on your phone, adding or removing entries as needed.
The Policy Assignment APIs function like a set of rules you might set up for a group project. They let admins assign or remove policies for users, ensuring everyone follows the same guidelines, much like setting ground rules for how a team should collaborate on a project.
These APIs are designed to work seamlessly with existing tools and workflows, providing flexibility and automation. They support both delegated and application permissions, meaning they can be used in various commercial environments. This is similar to having a universal remote that can control multiple devices, not just your TV, making it easier to manage everything from one place.
Admins who manage Teams users, policies, or voice configurations will find these APIs particularly useful. They can begin exploring these new tools using the Microsoft Graph V1.0 or beta endpoints, ensuring their applications and scripts have the correct permissions. For any questions or feedback, Microsoft has provided a contact email for further assistance.
** AI generated content. This information must be reviewed before use.
a free basic plan is required to see more details. Sign up here
A cloudsocut.one plan is required to see all the changed details. If you are already a customer, choose login.
If you are new to cloudscout.one please choose a plan.
change history
| Date | Property | old | new |
| 2026-01-21 | MC prepare | Begin exploring the APIs using the Microsoft Graph beta endpoints.
Ensure your applications and scripts use the appropriate permission scopes. For feedback or questions, contact: TeamsAdminGraphApi@microsoft.com Learn more: User Configuration Graph API - List userConfigurations | Microsoft Graph | Microsoft Learn Number Management Graph API(s) - List numberAssignments | Microsoft Graph | Microsoft Learn Policy Assignment/Un-Assignment Graph API(s) - teamsPolicyUserAssignment: assign | Microsoft Graph | Microsoft Learn [Compliance considerations:] No compliance considerations identified, review as appropriate for your organization. https://learn.microsoft.com/graph/api/teamsadministration-teamsadminroot-list-userconfigurations?view=graph-rest-beta&tabs=http https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta https://learn.microsoft.com/graph/api/teamsadministration-telephonenumbermanagementroot-list-numberassignments?view=graph-rest-beta | Begin exploring the APIs using the Microsoft Graph V1.0/beta endpoints.
Ensure your applications and scripts use the appropriate permission scopes. For feedback or questions, contact: TeamsAdminGraphApi@microsoft.com Learn more: User Configuration Graph API - List userConfigurations | Microsoft Graph | Microsoft Learn Number Management Graph API(s) - List numberAssignments | Microsoft Graph | Microsoft Learn Policy Assignment/Un-Assignment Graph API(s) - teamsPolicyUserAssignment: assign | Microsoft Graph | Microsoft Learn [Compliance considerations:] No compliance considerations identified, review as appropriate for your organization. https://learn.microsoft.com/graph/api/teamsadministration-teamsadminroot-list-userconfigurations?view=graph-rest-1.0 https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta https://learn.microsoft.com/graph/api/teamsadministration-telephonenumbermanagementroot-list-numberassignments?view=graph-rest-beta |
| 2026-01-21 | MC MessageTagNames | New feature, User impact, Admin impact | Updated message, New feature, User impact, Admin impact |
| 2026-01-21 | MC Summary | Microsoft Graph beta now offers Teams administration APIs for user configuration, number management, and policy assignment. These enable automation and integration for Teams management, accessible with delegated or application permissions in commercial environments. Admins can begin exploring these APIs and ensure proper permission scopes. | Microsoft Graph now offers Teams administration APIs: Teams User Configuration API (V1.0), Number Management, and Policy Assignment APIs (beta). These enable automation of user settings, phone number management, and policy assignments for Teams admins. APIs support delegated and application permissions in commercial environments. |
| 2026-01-21 | MC Last Updated | 10/10/2025 01:27:31 | 2026-01-20T18:37:01Z |
| 2026-01-21 | MC Messages | Microsoft Graph now includes APIs that support Teams administration scenarios through beta:
Teams User Configuration API Number Management APIs Policy Assignment APIs These APIs enable programmatic access to user configurations, telephone number management, and policy assignments-helping organizations automate and scale Teams management. They are designed to support extensibility, automation, and integrations with your existing tools and workflows. [When this will happen:] Please note that these APIs are currently available via the Microsoft Graph through beta. They are supported in commercial environments and accessible through both delegated and application permissions. | Updated January 20, 2026: We have updated the content. Thank you for your patience.
Microsoft Graph now includes APIs that support Teams administration scenarios through beta: Teams User Configuration API - Available through V1.0 Number Management APIs - Available through beta Policy Assignment APIs - Available through beta These APIs enable programmatic access to user configurations, telephone number management, and policy assignments-helping organizations automate and scale Teams management. They are designed to support extensibility, automation, and integrations with your existing tools and workflows. [When this will happen:] Please note that only Teams User Configuration API is currently available via the Microsoft Graph through V1.0, rest of the two APIs (Number Management and Policy Assignment) are currently available via the Microsoft Graph through beta. They are supported in commercial environments and accessible through both delegated and application permissions. |
| 2026-01-21 | MC How Affect | Who is affected: Admins managing Teams users, policies, or voice configurations.
What will happen: Teams User Configuration API: Retrieve detailed Teams settings for users, including effective policy assignments and voice attributes. Details: List userConfigurations Number Management APIs: Retrieve telephone number details, assign, and unassign telephone numbers. Details: List numberAssignments Policy Assignment APIs: Assign or unassign Teams policies for users. Details: teamsPolicyUserAssignment: assign | Who is affected: Admins managing Teams users, policies, or voice configurations.
What will happen: Teams User Configuration API: Retrieve detailed Teams settings for users, including effective policy assignments and voice attributes. Details: List userConfigurations - Microsoft Graph v1.0 | Microsoft Learn Number Management APIs: Retrieve telephone number details, assign, and unassign telephone numbers. Details: List numberAssignments Policy Assignment APIs: Assign or unassign Teams policies for users. Details: teamsPolicyUserAssignment: assign |
| 2026-01-21 | MC Title | Microsoft Teams: Microsoft Graph APIs for Teams administration now available in beta | (Updated) Microsoft Teams: Microsoft Graph APIs for Teams administration now available in beta |
| 2026-01-21 | MC End Time | 12/01/2025 09:00:00 | 2026-02-20T09:00:00Z |
Last updated 1 month ago ago
