Retirement of the agentRegistry API and new licensing requirements for the Agent 365 Graph API

As announced in April, Microsoft is transitioning agent registration to a new Agent 365 Graph API as part of the broader consolidation of agent management.

• This retirement affects organizations with custom-developed agents that are self-registered via the existing agent registry Graph API. Agents created through Microsoft agent builder platforms, such as Copilot Studio or Foundry, are not affected.
• This change also matters if you want to use the new Agent 365 Graph API, which is only available if your organization has ordered the new Agent 365 license.

Timeline

• The rollout of the new Agent 365 Graph API should be completed in May 2026.
• The existing agent registry Graph API begins retirement on 15 June 2026 and will be unsupported thereafter.

How does this affect your organization?

In April, Microsoft announced changes to the Agent Registry in Microsoft Entra and that the agentRegistry Graph API will be retired soon.

This update provides more detail on the retirement of the registry Graph API, covering Microsoft’s next steps and the licensing requirements for the new Agent 365 Graph API.

• The new Agent 365 Graph API is now available to all customers, still in Public Preview.
• The existing agent registry Graph API will be retired and no longer supported from 15 June 2026.
• Agents registered only through the existing API must be re-registered before 15 June 2026, or they will stop working.

Important:
The retirement of the previous agent registry Graph API does not affect agents created through Microsoft agent builder platforms such as Copilot Studio or Foundry. You are affected if you use self-registered agents via the agent registry Graph API for custom-developed agents.

Microsoft is also pushing the adoption of the new Agent 365 license with the Agent 365 Graph API, as expected. Your organization needs at least one Agent 365 license to use the new API.

Microsoft describes two use cases for the new API:

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

Calling the new endpoints without at least one Agent 365 license in the tenant returns a Forbidden error indicating the Agent 365 license is missing.

Import-Module Microsoft.Graph.Authentication
Connect-MgGraph -Scopes "CopilotPackages.Read.All"

$Url = "https://graph.microsoft.com/beta/copilot/admin/catalog/packages"
try {
    $Result = Invoke-MgGraphRequest -Method GET -Uri $Url -ErrorAction Stop
} catch {
    ($_.Exception.Message -split "`n")[0..1]
    $ErrorJson = ($_.ErrorDetails.Message -split "`n" | Where-Object { $_.Trim() -match '^\{' }) | Select-Object -Last 1
    $ErrorJson | ConvertFrom-Json | ConvertTo-Json -Depth 10
}

Import-Module Microsoft.Graph.Authentication
Connect-MgGraph -Scopes "CopilotPackages.Read.All"

$Url = "https://graph.microsoft.com/beta/copilot/admin/catalog/packages"
try {
    $Result = Invoke-MgGraphRequest -Method GET -Uri $Url -ErrorAction Stop
} catch {
    ($_.Exception.Message -split "`n")[0..1]
    $ErrorJson = ($_.ErrorDetails.Message -split "`n" | Where-Object { $_.Trim() -match '^\{' }) | Select-Object -Last 1
    $ErrorJson | ConvertFrom-Json | ConvertTo-Json -Depth 10
}