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"
}
]
}