Microsoft Graph · Schema

microsoft.graph.plannerTask

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

Name Type Description
activeChecklistItemCount number Number of checklist items with value set to false, representing incomplete items.
appliedCategories object 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 object 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's 28 characters long and case-sensitive. Format validation is done on the service.
checklistItemCount number Number of checklist items that are present on the task.
completedBy object Identity of the user that completed the task.
completedDateTime string 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 exampl
conversationThreadId string Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.
createdBy object Identity of the user that created the task.
createdDateTime string 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
dueDateTime string 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-01T
hasDescription boolean Read-only. Value is true if the details object of the task has a nonempty description and false otherwise.
orderHint string Hint used to order items of this type in a list view. The format is defined as outlined here.
percentComplete number Percentage of task completion. When set to 100, the task is considered completed.
planId string Plan ID to which the task belongs.
previewType object This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist, description, reference.
priority number Priority of the task. The valid range of values is between 0 and 10, with the increasing value being lower priority (0 has the highest priority and 10 has the lowest priority). Currently, Planner inte
referenceCount number Number of external references that exist on the task.
startDateTime string 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-01T
title string Title of the task.
assignedToTaskBoardFormat object Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
bucketTaskBoardFormat object Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
details object Read-only. Nullable. More details about the task.
progressTaskBoardFormat object Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
@odata.type string
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphplannertask-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.plannerTask",
  "title": "microsoft.graph.plannerTask",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.entity"
    },
    {
      "title": "plannerTask",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "activeChecklistItemCount": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": "number",
          "description": "Number of checklist items with value set to false, representing incomplete items.",
          "format": "int32",
          "nullable": true
        },
        "appliedCategories": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerAppliedCategories"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The categories to which the task has been applied. See applied Categories for possible values."
        },
        "assigneePriority": {
          "type": "string",
          "description": "Hint used to order items of this type in a list view. The format is defined as outlined here.",
          "nullable": true
        },
        "assignments": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerAssignments"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The set of assignees the task is assigned to."
        },
        "bucketId": {
          "type": "string",
          "description": "Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It's 28 characters long and case-sensitive. Format validation is done on the service.",
          "nullable": true
        },
        "checklistItemCount": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": "number",
          "description": "Number of checklist items that are present on the task.",
          "format": "int32",
          "nullable": true
        },
        "completedBy": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.identitySet"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Identity of the user that completed the task."
        },
        "completedDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "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",
          "format": "date-time",
          "nullable": true
        },
        "conversationThreadId": {
          "type": "string",
          "description": "Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.",
          "nullable": true
        },
        "createdBy": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.identitySet"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Identity of the user that created the task."
        },
        "createdDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "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",
          "format": "date-time",
          "nullable": true
        },
        "dueDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "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",
          "format": "date-time",
          "nullable": true
        },
        "hasDescription": {
          "type": "boolean",
          "description": "Read-only. Value is true if the details object of the task has a nonempty description and false otherwise.",
          "nullable": true
        },
        "orderHint": {
          "type": "string",
          "description": "Hint used to order items of this type in a list view. The format is defined as outlined here.",
          "nullable": true
        },
        "percentComplete": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": "number",
          "description": "Percentage of task completion. When set to 100, the task is considered completed.",
          "format": "int32",
          "nullable": true
        },
        "planId": {
          "type": "string",
          "description": "Plan ID to which the task belongs.",
          "nullable": true
        },
        "previewType": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerPreviewType"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist, description, reference."
        },
        "priority": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": "number",
          "description": "Priority of the task. The valid range of values is between 0 and 10, with the 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, 3 and 4 as 'important', 5, 6, and 7 as 'medium', and 8, 9, and 10 as 'low'.  Additionally, Planner sets the value 1 for 'urgent', 3 for 'important', 5 for 'medium', and 9 for 'low'.",
          "format": "int32",
          "nullable": true
        },
        "referenceCount": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": "number",
          "description": "Number of external references that exist on the task.",
          "format": "int32",
          "nullable": true
        },
        "startDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "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",
          "format": "date-time",
          "nullable": true
        },
        "title": {
          "type": "string",
          "description": "Title of the task."
        },
        "assignedToTaskBoardFormat": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.",
          "x-ms-navigationProperty": true
        },
        "bucketTaskBoardFormat": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.",
          "x-ms-navigationProperty": true
        },
        "details": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerTaskDetails"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Read-only. Nullable. More details about the task.",
          "x-ms-navigationProperty": true
        },
        "progressTaskBoardFormat": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.plannerTask"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphplannertask"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.