plannerAppliedCategories resource type

Namespace: microsoft.graph


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.

The AppliedCategoriesCollection resource represents the collection of categories (or labels) that have been applied to a task. It is part of the plannerTask object. There can be up to 6 categories applied to a task. Category descriptions, e.g. category1, category2 etc., are part of the plan details object. This is an open type.


Properties of an Open Type can be defined by the client. In this case though, the client must provide category1, category2, category3, category4, category5 and/or category6 as properties with their values being the true boolean when the corresponding categories are applied on the task. Example is shown below. When they do not apply, properties are automatically removed by setting their values to the false boolean.

JSON representation

Here is a JSON representation of the resource

  "String-value": true


  "category1": true,
  "category3": true,
  "category5": true