MC1173195 - Microsoft 365 Copilot: Graph APIs for agent and app management

Updated December 3, 2025: 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 mid-January 2026 (previously early December 2025) and is expected to complete by end of January 2026 (previously mid-December 2025).

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.