Bewerken

Agent and app Package Management API overview (preview)

A package represents either an agent or Microsoft 365 app in the organization catalog. The Package Management API enables IT administrators to view and manage apps and agents across Microsoft 365. This API provides endpoints to list all apps and agents, retrieve detailed information about an individual app or agent including metadata and detailed elements.

Important

Access to the Package Management API requires a Microsoft Agent 365 license.

Key capabilities

  • Retrieve an inventory of all agents and apps within the organization, optionally filtering by:
    • Host (Copilot, Outlook, Teams)
    • Last updated time
    • Element types contained in the app package (bots, declarative agents, etc.).
  • Retrieve more metadata for a specific app or agent.
  • Block, unblock, and reassign ownership of packages.

Example scenarios

  • Organization admin retrieves the inventory of all Copilot agents and Microsoft 365 apps.
  • Admin reviews package details, including availability and deployment status.
  • Admin reviews agent element details, including declarativeAgent or customEngineAgent element object.
  • Admin blocks a package to prevent its usage across the organization.
  • Admin reassigns package ownership when an employee leaves the organization.

API list

Operation HTTP Method Description
List packages GET /copilot/admin/catalog/packages Get all apps and agents in the organization.
Get package details GET /copilot/admin/catalog/packages/{id} Get detailed metadata for a specific app or agent.
Update package PATCH /copilot/admin/catalog/packages/{id} Update package metadata.
Block POST /copilot/admin/catalog/packages/{id}/block Block a package to prevent its usage.
Unblock POST /copilot/admin/catalog/packages/{id}/unblock Unblock a package to allow its usage.
Reassign POST /copilot/admin/catalog/packages/{id}/reassign Reassign ownership of a package to a different user.

Resources

Related content

  • Last updated on