💡 Our Technical Review in summary
- Microsoft is introducing two new Microsoft Graph API endpoints designed for the programmatic management and reporting of Microsoft 365 Copilot agents and apps.
- These APIs allow administrators to bypass manual UI workflows, enabling automated inventory tracking and integration into custom IT management tools.
- Timeline: The rollout is scheduled to begin in early February 2026 and is expected to reach General Availability by mid-February 2026.
- Roadmap ID: 502875.
Impact
- Enhanced Visibility: Admins can now retrieve a complete inventory of all agents and apps (including Microsoft-provided, External, Shared, and Custom versions) using the
GET /copilot/admin/catalog/packagesendpoint. - Granular Data: Detailed metadata and manifest details for specific agents can be retrieved via the
GET /copilot/admin/catalog/packages/{id}endpoint. - No Workflow Disruption: This update does not change existing Microsoft 365 admin center UI workflows or existing admin policies.
- Licensing: These endpoints are included with existing Microsoft 365 licenses; no additional add-on or Copilot-specific licensing is required to access these administrative APIs.
Action Required
- Documentation Review: IT Administrators and Developers should review the Microsoft Graph API documentation to understand the schema and authentication requirements for these new endpoints.
- Automation Planning: Evaluate internal reporting needs. If your organization currently tracks Copilot agent usage manually, plan to transition these workflows to automated scripts using the new APIs.
- Permission Audit: Ensure that service principals or admin accounts intended to use these APIs are granted the necessary Graph permissions (e.g.,
Copilot.Read.Allor similar, as specified in the upcoming documentation). - Monitor Rollout: Verify availability within your tenant starting in early February 2026.
Microsoft Official Update
Service: N/A
Category: stayInformed
Severity: normal
Updated January 12, 2026: We have updated the timeline. Thank you for your patience.
[Introduction]
We are introducing two new Microsoft Graph APIs that enable admins to programmatically access and manage agents and apps within their organization. These APIs provide greater flexibility for reporting and integration scenarios without relying on manual UI workflows.
This message is associated with Microsoft 365 Roadmap ID 502875.
[When this will happen:]
General Availability (Worldwide): Rollout will begin in early February 2026 (previously mid-January) and is expected to complete by mid-February 2026 (previously end of January).
[How this affects your organization:]
Who is affected:
Admins managing Copilot agents and apps within Microsoft 365 environments.
What will happen:
- New Graph API endpoints will be available:
- GET graph.microsoft.com/copilot/admin/catalog/packages – Retrieves a complete inventory of all agents and apps (Microsoft, External, Shared, and Custom).
- GET graph.microsoft.com/copilot/admin/catalog/packages/{id} – Fetches detailed metadata for a specific agent or app, including properties and manifest details.
- These APIs allow for automated reporting and integration workflows.
- No changes to existing UI workflows or admin policies.
- These Graph API endpoints are available to users with an existing Microsoft 365 license; no additional license or add-on is required.
[What you can do to prepare:]
- Review the Microsoft Graph API documentation to familiarize yourself with usage and capabilities at this time.
[Compliance considerations:]
No compliance considerations identified, review as appropriate for your organization.
