plannerTask resource type

Namespace: microsoft.graph

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.

Represents a Planner task in Microsoft 365. A Planner task is contained in a plan and can be assigned to a bucket in a plan. Each task object has a details object that can contain more information about the task. For more information about relationships between group, plan, and task, see Use the Planner REST API

Methods

Method Return Type Description
Get plannerTask plannerTask Read properties and relationships of plannerTask object.
Update plannerTask Update plannerTask object.
Delete None Delete plannerTask object.
Get delta plannerTask collection Get newly created, updated, or deleted plannerTask objects in either a plannerPlan or assigned to the signed-in user without having to perform a full read of the entire resource collection.

Properties

Property Type Description
activeChecklistItemCount Int32 Number of checklist items with value set to false, representing incomplete items.
appliedCategories plannerAppliedCategories The categories to which the task has been applied. See applied Categories for possible values.
assigneePriority String Hint used to order items of this type in a list view. The format is defined as outlined here.
assignments plannerAssignments The set of assignees the task is assigned to.
bucketId String Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It is 28 characters long and case-sensitive. Format validation is done on the service.
checklistItemCount Int32 Number of checklist items that are present on the task.
completedBy identitySet Identity of the user that completed the task.
completedDateTime DateTimeOffset Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
conversationThreadId String Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.
createdBy identitySet Identity of the user that created the task.
createdDateTime DateTimeOffset Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
creationSource plannerTaskCreation Contains information about the origin of the task.
dueDateTime DateTimeOffset Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
hasDescription Boolean Read-only. Value is true if the details object of the task has a nonempty description and false otherwise.
id String Read-only. ID of the task. It is 28 characters long and case-sensitive. Format validation is done on the service.
orderHint String Hint used to order items of this type in a list view. The format is defined as outlined here.
percentComplete Int32 Percentage of task completion. When set to 100, the task is considered completed.
priority Int32 Priority of the task. Valid range of values is between 0 and 10 (inclusive), with increasing value being lower priority (0 has the highest priority and 10 has the lowest priority). Currently, Planner interprets values 0 and 1 as "urgent", 2 and 3 and 4 as "important", 5, 6, and 7 as "medium", and 8, 9, and 10 as "low". Currently, Planner sets the value 1 for "urgent", 3 for "important", 5 for "medium", and 9 for "low".
planId String Plan ID to which the task belongs.
previewType String This sets the type of preview that shows up on the task. Possible values are: automatic, noPreview, checklist, description, reference.
recurrence plannerTaskRecurrence Defines active or inactive recurrence for the task. null when the recurrence has never been defined for the task.
referenceCount Int32 Number of external references that exist on the task.
specifiedCompletionRequirements plannerTaskCompletionRequirements Indicates all the requirements specified on the plannerTask. Possible values are: none, checklistCompletion, unknownFutureValue. Read-only. The plannerTaskCompletionRequirementDetails in plannerTaskDetails has details of the requirements specified, if any.
startDateTime DateTimeOffset Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
title String Title of the task.

plannerTaskCompletionRequirements values

Member Description
none No requirement.
checklistCompletion Some or all of the checklist items are required to be checked.
unknownFutureValue Evolvable enumeration sentinel value. Don't use.

Relationships

Relationship Type Description
assignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormat Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
bucketTaskBoardFormat plannerBucketTaskBoardTaskFormat Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
details plannerTaskDetails Read-only. Nullable. Additional details about the task.
progressTaskBoardFormat plannerProgressTaskBoardTaskFormat Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.

JSON representation

Here's a JSON representation of the resource.

{
  "activeChecklistItemCount": "Int32",
  "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
  "assigneePriority": "String",
  "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
  "bucketId": "String",
  "checklistItemCount": "Int32",
  "completedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "completedDateTime": "String (timestamp)",
  "conversationThreadId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": "String (timestamp)",
  "hasDescription": "Boolean",
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": "Int32",
  "planId": "String",
  "previewType": "String",
  "priority": "Int32",
  "recurrence": {"@odata.type": "microsoft.graph.plannerTaskRecurrence"},
  "referenceCount": "Int32",
  "specifiedCompletionRequirements": "String",
  "startDateTime": "String (timestamp)",
  "title": "String"
}