categoryTemplate resource type

Namespace: microsoft.graph.security

Specifies a group of similar types of content in a particular department. This resource supports CRUD operations to apply and manage the filePlanAppliedCategory descriptor, and any filePlanSubcategory descriptor for a retentionLabel. These file plan descriptors supplement a retention label to improve the manageability and organization of Microsoft 365 content.

Inherits from microsoft.graph.security.filePlanDescriptorTemplate.

Methods

Method	Return type	Description
List categories	microsoft.graph.security.categoryTemplate collection	Get a list of the microsoft.graph.security.categoryTemplate objects and their properties.
Create categories	microsoft.graph.security.categoryTemplate	Create a new microsoft.graph.security.categoryTemplate object.
Get categories	microsoft.graph.security.categoryTemplate	Read the properties and relationships of a microsoft.graph.security.categoryTemplate object.
Delete categories	None	Delete a microsoft.graph.security.categoryTemplate object.
List subcategories	microsoft.graph.security.subcategoryTemplate collection	Get the subcategoryTemplate resources from the subcategories navigation property.
Create subcategories	microsoft.graph.security.subcategoryTemplate	Create a new subcategoryTemplate object.

Properties

Property	Type	Description
createdBy	microsoft.graph.identitySet	Represents the user who created the category descriptor. Inherited from microsoft.graph.security.filePlanDescriptorTemplate. Read-only.
createdDateTime	DateTimeOffset	Represents the date and time in which the category descriptor is created. Inherited from microsoft.graph.security.filePlanDescriptorTemplate. Read-only.
displayName	String	Unique string that defines a category name. Inherited from microsoft.graph.security.filePlanDescriptorTemplate.
id	String	Unique ID of the category. Inherited from microsoft.graph.entity. Read-only.

Relationships

Relationship	Type	Description
subcategories	microsoft.graph.security.subcategoryTemplate collection	Represents all subcategories under a particular category.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.security.categoryTemplate",
  "id": "String (identifier)",
  "displayName": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)"
}