Updated November 19, 2025: We have updatedApril 30, 2026: The API will be in Public Preview starting 05/01 and will be available to all customers. Customers must be licensed for Agent 365 in order to use the timeline.Agent 365 Graph APIs. 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:
Frontier (Preview): Now available.
General Availability (Worldwide): Rollout will begin in early December 2025mid-April 2026 (previously mid-November)end of March) and is expected to complete by mid-December 2025early May 2026 (previously late November)end of February).
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:
Compliance considerations:
No compliance considerations identified, review as appropriate for your organization.