categoryTemplate resource type

Namespace: microsoft.graph.security

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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