Agent Registry API transition to Agent 365
Microsoft is consolidating agent management with Agent 365, introducing a new Agent 365–powered agent registration Graph API available May 1, 2026. The existing agent registry API will retire June 15, 2026; agents not re-registered by then will stop working. Admins must update registrations and documentation accordingly.

As previously announced in MC1275311, Microsoft is consolidating agent management to simplify how administrators observe, govern, and secure agents, with Agent 365 (A365) as the single source of truth. A new Agent 365–powered agent registration Microsoft Graph API supports this consolidation and replaces the existing agent registry Graph API. This message provides API‑specific details and required actions.
When this will happen
- General Availability (Worldwide): Rollout begins in early May 2026 and is expected to complete by late May 2026.
- API retirement: The existing agent registry Graph API will begin retirement on June 15, 2026.
How this affects your organization
Who is affected
- Microsoft 365 tenants with agents self‑registered using the existing agent registry Graph API
- Developers or administrators responsible for custom agent lifecycle management
Note: This change does not apply to agents created through Microsoft agent builder platforms such as Copilot Studio or Foundry.
What will happen
- A new Agent 365–powered agent registration Graph API is available as of May 1, 2026.
- The existing agent registry Graph API will no longer be supported starting June 15, 2026.
- Agents registered only through the existing API and not re‑registered before retirement will stop functioning.
- Administrators can view all registered agents in the All agents view in the Microsoft 365 admin center (MAC).
- This message fulfills the API transition previously referenced in MC1275311.
What you can do to prepare
- Identify agent instances registered using the existing agent registry Graph API.
- Re‑register those agents using the new Agent 365–powered agent registration Graph API before June 15, 2026.
- Verify agent registrations in the All agents view in MAC.
- Update internal documentation or automation that references the existing API.
- Communicate this change to development and platform teams responsible for agent management.
Learn more:
- Agent Registration API overview | Extensibility | Microsoft 365 Copilot | Microsoft Learn
- agentRegistry resource type | Microsoft Graph | Microsoft Learn
- Microsoft Entra releases and announcements | Fundamentals | Microsoft Entra | Microsoft Learn
Compliance considerations
| Question | Answer |
| Does this change introduce or significantly modify AI/ML or agent capabilities that interact with customer data? | Yes. This change introduces a new Agent 365–powered agent registration API that governs how agents are registered and managed within Microsoft 365. It does not change agent behavior or access to customer data. |
| Does this change alter how admins can monitor, report on, or demonstrate compliance? | Yes. Agent inventory and lifecycle visibility are centralized in the Microsoft 365 admin center, providing a unified view aligned with Agent 365. |
Message ID: MC1297981

HANDS ON tek
M365 Admin


