Edit

List copilotPackagePolicyTemplate

Important

APIs under the /beta version are subject to change. Use of these APIs in production applications is not supported.

Get the available copilotPackagePolicyTemplate objects before selecting a policy template for Publish or native Activate.

Templates belong to the tenant, not an individual package. This operation returns template metadata, not policy definitions or assignments. A returned template still needs to be applicable to the package being published.

This proposed beta reference doesn't imply publication or deployment. A summary omits saved policyConfiguration. Use Get for saved settings and the separate template-bound policy definitions for complete applicable choices. Explicit Update and Copy are separate operations; discovery doesn't modify a template.

Important

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

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

Permission type Least privileged permissions Higher privileged permissions
Delegated (work or school account) CopilotPackages.Read.All CopilotPackages.ReadWrite.All
Delegated (personal Microsoft account) Not supported. Not supported.
Application CopilotPackages.Read.All CopilotPackages.ReadWrite.All

The target permission contract covers delegated and application callers. Matching backend support and applicable tenant authorization are separate release requirements; permission metadata isn't deployed application-only execution.

HTTP request

GET https://graph.microsoft.com/beta/copilot/admin/catalog/policyTemplates

This operation returns summaries. Get policy template separately reads one template by its opaque ID.

Optional query parameters

The existing summary paging contract is unchanged. Follow @odata.nextLink when returned rather than treating one page as the complete inventory. This reference doesn't establish a numeric page-size bound.

The single-response completeness and unsupported $top/$skip rules of List policy definitions apply only to that template-bound catalog, not this summary list.

Request headers

Name Description
Authorization Bearer access token. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and a value collection of copilotPackagePolicyTemplate objects in the response body.

Example

Request

The following example shows an illustrative request.

GET https://graph.microsoft.com/beta/copilot/admin/catalog/policyTemplates

Response

The following example shows an illustrative response.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "MicrosoftAgentDefaultTemplate",
      "displayName": "Default policy template for agents",
      "description": "Default policy template for agents"
    }
  ]
}