Microsoft Teams: Microsoft Graph APIs for Teams administration now available in beta
From Microsoft 365 Message Center Archive by Merill Fernando · Microsoft may not have sent this notice to your tenant.Rollout
Rollout dates are often only in the text. When Microsoft moves them, the change shows under "What changed".
What the notice says
Microsoft’s text, safely structuredUpdated 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.
How this affects your organization
- 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
What you can do to prepare
- 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: [email protected]
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.
What changed
Between archive captures, newest first- Tags
New feature, User impact, Admin impact→ Updated message, New feature, User impact, Admin impact
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 … your existing tools and workflows. When this will happen: Please note that
theseonly 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 … 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. … you can do to prepare:Begin exploring the APIs using the Microsoft GraphbetaV1.0/beta endpoints. Ensure your applications and scripts use the appropriate permission scopes. For …- Tags
- · first version seen
Learn more
Links from the notice and their documentation checks- List userConfigurations - Microsoft Graph v1.0 | Microsoft LearnNot read yet
- List numberAssignmentsNot read yet
- teamsPolicyUserAssignment: assignNot read yet
Related public evidence
No related evidence found in this installation's recent collection. This does not establish that no announcement exists.
Not confirmed here
What this page cannot tell you- Whether your tenant is affected: this is Microsoft's notice, not a check of your settings.
- 3 linked pages have not been read yet.