Microsoft Planner · Schema
PlannerTask
Represents a Planner task in Microsoft 365. A task is contained in a plan and can be assigned to a bucket within the plan.
CollaborationMicrosoft 365ProductivityProject ManagementTask Management
Properties
| Name | Type | Description |
|---|---|---|
| @odata.etag | string | The ETag of the resource, used for concurrency control |
| id | string | The unique identifier for the task. 28 characters long and case-sensitive. |
| title | string | Title of the task |
| planId | string | Plan ID to which the task belongs |
| bucketId | ['string', 'null'] | Bucket ID to which the task belongs. The bucket must be in the same plan as the task. 28 characters long and case-sensitive. |
| priority | integer | Priority of the task. Valid range is 0-10 where 0 is highest priority. Values 0-1 are urgent, 2-4 are important, 5-7 are medium, 8-10 are low. |
| percentComplete | integer | Percentage of task completion. When set to 100, the task is considered completed. |
| startDateTime | ['string', 'null'] | Date and time at which the task starts. ISO 8601 format, always in UTC. |
| dueDateTime | ['string', 'null'] | Date and time at which the task is due. ISO 8601 format, always in UTC. |
| completedDateTime | ['string', 'null'] | Date and time at which the percentComplete was set to 100. ISO 8601 format, always in UTC. |
| createdDateTime | string | Date and time at which the task was created. ISO 8601 format, always in UTC. |
| hasDescription | boolean | Indicates whether the details object of the task has a nonempty description. |
| conversationThreadId | ['string', 'null'] | Thread ID of the conversation on the task in the containing group. |
| orderHint | string | Hint used to order items of this type in a list view |
| assigneePriority | string | Hint used to order items of this type when grouped by assignee |
| previewType | string | The type of preview that shows on the task |
| activeChecklistItemCount | integer | Number of incomplete checklist items |
| checklistItemCount | integer | Total number of checklist items on the task |
| referenceCount | integer | Number of external references on the task |