| title | governancePolicyTemplate resource type |
|---|---|
| description | Represents a policy template that defines the configuration for governance relationships. |
| author | hafowler |
| ms.date | 03/10/2026 |
| ms.localizationpriority | medium |
| ms.subservice | entra-tenant-governance |
| doc_type | resourcePageType |
Namespace: microsoft.graph.tenantGovernanceServices
[!INCLUDE beta-disclaimer]
Represents a policy template that defines the configuration for governance relationships, including delegated administration role assignments and multi-tenant applications to provision. Policy templates are used when creating governanceRequest objects and are stored as snapshots in established governanceRelationship objects.
The system provides a default policy template with the ID default. This template serves as a reusable configuration that is applied when governance relationships are automatically created for add-on tenants. The default template cannot be deleted.
Inherits from microsoft.graph.entity.
| Method | Return type | Description |
|---|---|---|
| List | microsoft.graph.tenantGovernanceServices.governancePolicyTemplate collection | Get a list of the governancePolicyTemplate objects and their properties. |
| Create | microsoft.graph.tenantGovernanceServices.governancePolicyTemplate | Create a new governance policy template. |
| Get | microsoft.graph.tenantGovernanceServices.governancePolicyTemplate | Read the properties of a governancePolicyTemplate object, including the system-provided default template. |
| Update | microsoft.graph.tenantGovernanceServices.governancePolicyTemplate | Update the properties of a governance policy template, including the system-provided default template. |
| Delete | None | Delete a governance policy template. |
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The date and time when the template was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy. |
| delegatedAdministrationRoleAssignments | microsoft.graph.tenantGovernanceServices.delegatedAdministrationRoleAssignment collection | A collection of delegated administration role assignments to be applied in the governed tenant when the governance relationship is established. |
| description | String | A description of the policy template. Supports $filter (eq, ne) and $orderBy. |
| displayName | String | The display name of the policy template. Supports $filter (eq, ne) and $orderBy. |
| governedTenantCanTerminate | Boolean | Not implemented. |
| id | String | The unique identifier for the policy template. Is default for the default template. Inherited from entity.Supports $filter (eq, ne) and $orderBy. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the template was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy. |
| multiTenantApplicationsToProvision | microsoft.graph.tenantGovernanceServices.multiTenantApplicationsToProvision collection | A collection of multi-tenant applications to be provisioned in the governed tenant when the governance relationship is established. |
| version | String | The version of the policy template. Version count increased by 1 when updated. Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy. |
None.
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.tenantGovernanceServices.governancePolicyTemplate",
"id": "String (identifier)",
"displayName": "String",
"description": "String",
"governedTenantCanTerminate": "Boolean",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"version": "String",
"multiTenantApplicationsToProvision": [
{
"@odata.type": "microsoft.graph.tenantGovernanceServices.multiTenantApplicationsToProvision"
}
],
"delegatedAdministrationRoleAssignments": [
{
"@odata.type": "microsoft.graph.tenantGovernanceServices.delegatedAdministrationRoleAssignment"
}
]
}