MC1297981: 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 d...
[Introduction]
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. |