Updated April 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 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 mid-April 2026 (previously end of March) and is expected to complete by early May 2026 (previously 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:]

• 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.

2026年4月30日更新:APIは05/01からパブリックプレビューとなり、すべての顧客が利用可能になります。Agent 365のグラフAPIを利用するには、顧客がAgent 365のライセンスを持っている必要があります。ご辛抱いただきありがとうございます。

[はじめに]

管理者が組織内のエージェントやアプリにプログラム的にアクセス・管理できるようにする、2つの新しい Microsoft Graph API を導入します。これらのAPIは、手動のUIワークフローに頼らずに、レポートや統合シナリオの柔軟性を高めます。

このメッセージはMicrosoft 365 Roadmap ID 502875に関連付けられています。

[いつ起こるか:]

フロンティア(プレビュー): 現在発売中です。 

一般公開(世界): 展開は2026年4月中旬(以前は3月末)に開始され、2026年5月初旬(以前は2月末)までに完了する見込みです。

[これがあなたの組織にどのような影響を与えるか:]

影響を受ける人物:
管理者がMicrosoft 365環境内でCopilotエージェントやアプリを管理すること。

今後の展開:

• 新しいGraph APIエンドポイントが利用可能になります:
  • GET graph.microsoft.com/copilot/admin/catalog/packages – すべてのエージェントとアプリ(Microsoft、External、Shared、Custom)の完全なインベントリを取得します。
  • GET graph.microsoft.com/copilot/admin/catalog/packages/{id} – 特定のエージェントやアプリの詳細なメタデータ(プロパティやマニフェストの詳細を含む)を取得します。

• これらのAPIは、自動的なレポート作成や統合ワークフローを可能にします。
• 既存のUIワークフローや管理者ポリシーの変更はありません。
• これらのGraph APIエンドポイントは、既存のMicrosoft 365ライセンスを持つユーザーが利用可能です。追加のライセンスやアドオンは必要ありません。

[準備のためにできること:]

• 現時点での使用状況や機能に慣れるために 、Microsoft Graph APIのドキュメント を確認しましょう。

[コンプライアンス上の考慮事項:]

コンプライアンス上の懸念事項は特定されず、組織に応じてレビューしてください。