Summary
- Microsoft is retiring the legacy Entra agent registry API and requires migration to the new Agent 365 registry API.
- Organizations using applications, agents, or services that register or manage agents through the legacy API are affected.
- Microsoft 365 admins and development teams should inventory dependencies, validate agent workflows, and update any automation that calls the old API.
- No automatic migration is provided; if migration is not completed, agent registration and lifecycle workflows may stop functioning.
- Review the referenced documentation and prior Message Center guidance to complete the transition before the legacy API is disabled.
Primary Service: Entra
Admin Impact: High
User Impact: Low
Release Start: 15 Aug 2026
Release End: 15 Aug 2026
Services: Entra, Graph, M365 Copilot
Category: Plan for change
Tags: Admin Action, Retirement
History
7/24/2026 Item Added to Message Center
Microsoft Message
What and Why
Microsoft is retiring the legacy Entra agent registry API on August 15, 2026. To improve the manageability, reliability, and long-term supportability of agent registration experiences, organizations must migrate to the new Agent 365 registry API before the retirement date. This update supports Microsoft’s enterprise-ready AI strategy by providing a modern registration framework for agents and ensuring continued service availability after the legacy API is retired.
Rollout Schedule
- Current status: Legacy Entra agent registry API remains available.
- Retirement date: August 15, 2026.
- After August 15, 2026: The legacy registry API will stop responding and will no longer be supported.
Impact on Your Organization
Who is affected
- Organizations that have applications, agents, or services currently calling the legacy Entra agent registry API.
- Microsoft 365 administrators responsible for agent deployment and lifecycle management.
- Development teams managing registered agents.
Platforms/Services
- Microsoft Entra
- Microsoft 365 Copilot extensibility and agent ecosystem
- Agent registration services
- Microsoft Graph-based agent management integrations
What will happen
- The legacy Entra agent registry API will be retired on August 15, 2026.
- Requests sent to the retired API after that date will no longer return responses.
- Organizations currently using the legacy API must migrate to the new Agent 365 registry API.
- No automatic migration will occur.
- Existing agent registration workflows that depend on the legacy API may stop functioning if migration is not completed before the retirement date.
- This change affects administrators and developers managing agent registrations.
- End-user experiences may be impacted only if dependent agent services fail due to incomplete migration.
Action Required / Recommendations
- Review whether your organization is currently using the legacy Entra agent registry API.
- Identify all applications, services, and agents that depend on the legacy API.
- Plan and complete migration to the new Agent 365 registry API before August 15, 2026.
- Validate agent registration and management workflows after migration.
- Inform application owners, development teams, and support staff about the retirement timeline.
- Update internal documentation and deployment guidance related to agent registration.
- Review the Microsoft Graph legacy Agent Registry API documentation.
- Review the Agent 365 Registry API overview documentation.
- Review Message center communication MC1275311.
- Contact your Microsoft account team if migration assistance is required.
Compliance Considerations
No compliance considerations identified, review as appropriate for your organization.