Microsoft Graph planner.plannerTask API

openapi: 3.2.0
info:
  title: Microsoft Graph Admin Admin.admin Planner.planner Task API
  description: 'Microsoft Graph API for managing administrative resources in Microsoft Entra ID.

    This API enables administrators to manage Microsoft Edge browser settings, Internet Explorer mode configurations,

    site lists, shared browser sites, Microsoft 365 Apps installation options, people insights, service announcements,

    SharePoint settings, Copilot administration, directory administrative units, and admin consent policies.'
  version: 1.0.0
  contact:
    name: Microsoft Graph API Support
    url: https://developer.microsoft.com/graph
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph API v1.0 endpoint
tags:
- name: planner.plannerTask
  x-ms-docs-toc-type: page
paths:
  /planner/tasks:
    description: Provides operations to manage the tasks property of the microsoft.graph.planner entity.
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph List plannerTask objects
      description: Retrieve a list of plannertask objects.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/planner-list-tasks?view=graph-rest-1.0
      operationId: planner.ListTasks
      parameters:
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.plannerTaskCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Create plannerTask
      description: Create a new plannerTask.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/planner-post-tasks?view=graph-rest-1.0
      operationId: planner.CreateTasks
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerTask'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerTask'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/tasks/{plannerTask-id}:
    description: Provides operations to manage the tasks property of the microsoft.graph.planner entity.
    parameters:
    - name: plannerTask-id
      in: path
      description: The unique identifier of plannerTask
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerTask
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Get plannerTask
      description: Retrieve the properties and relationships of plannerTask object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannertask-get?view=graph-rest-1.0
      operationId: planner.GetTasks
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerTask'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Update plannerTask
      description: Update the properties of plannerTask object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannertask-update?view=graph-rest-1.0
      operationId: planner.UpdateTasks
      parameters:
      - name: If-Match
        in: header
        description: ETag value.
        required: true
        schema:
          type: string
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerTask'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerTask'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Delete plannerTask
      description: Delete a plannerTask object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannertask-delete?view=graph-rest-1.0
      operationId: planner.DeleteTasks
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/tasks/{plannerTask-id}/assignedToTaskBoardFormat:
    description: Provides operations to manage the assignedToTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerTask-id
      in: path
      description: The unique identifier of plannerTask
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerTask
    x-ms-docs-grouped-path:
    - /planner/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Get plannerAssignedToTaskBoardTaskFormat
      description: Retrieve the properties and relationships of a plannerAssignedToTaskBoardTaskFormat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerassignedtotaskboardtaskformat-get?view=graph-rest-1.0
      operationId: planner.tasks.GetAssignedToTaskBoardFormat
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Update plannerAssignedToTaskBoardTaskFormat
      description: Update the properties of plannerAssignedToTaskBoardTaskFormat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerassignedtotaskboardtaskformat-update?view=graph-rest-1.0
      operationId: planner.tasks.UpdateAssignedToTaskBoardFormat
      parameters:
      - name: If-Match
        in: header
        description: ETag value.
        required: true
        schema:
          type: string
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Delete navigation property assignedToTaskBoardFormat for planner
      operationId: planner.tasks.DeleteAssignedToTaskBoardFormat
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/tasks/{plannerTask-id}/bucketTaskBoardFormat:
    description: Provides operations to manage the bucketTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerTask-id
      in: path
      description: The unique identifier of plannerTask
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerTask
    x-ms-docs-grouped-path:
    - /planner/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Get plannerBucketTaskBoardTaskFormat
      description: Retrieve the properties and relationships of plannerBucketTaskBoardTaskFormat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerbuckettaskboardtaskformat-get?view=graph-rest-1.0
      operationId: planner.tasks.GetBucketTaskBoardFormat
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Update plannerBucketTaskBoardTaskFormat
      description: Update the properties of a plannerBucketTaskBoardTaskFormat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerbuckettaskboardtaskformat-update?view=graph-rest-1.0
      operationId: planner.tasks.UpdateBucketTaskBoardFormat
      parameters:
      - name: If-Match
        in: header
        description: ETag value.
        required: true
        schema:
          type: string
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Delete navigation property bucketTaskBoardFormat for planner
      operationId: planner.tasks.DeleteBucketTaskBoardFormat
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/tasks/{plannerTask-id}/details:
    description: Provides operations to manage the details property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerTask-id
      in: path
      description: The unique identifier of plannerTask
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerTask
    x-ms-docs-grouped-path:
    - /planner/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/details
    - /planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/details
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/details
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Get plannerTaskDetails
      description: Retrieve the properties and relationships of a plannerTaskDetails object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannertaskdetails-get?view=graph-rest-1.0
      operationId: planner.tasks.GetDetails
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Update plannertaskdetails
      description: Update the properties of plannerTaskDetails object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannertaskdetails-update?view=graph-rest-1.0
      operationId: planner.tasks.UpdateDetails
      parameters:
      - name: If-Match
        in: header
        description: ETag value.
        required: true
        schema:
          type: string
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Delete navigation property details for planner
      operationId: planner.tasks.DeleteDetails
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/tasks/{plannerTask-id}/progressTaskBoardFormat:
    description: Provides operations to manage the progressTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerTask-id
      in: path
      description: The unique identifier of plannerTask
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerTask
    x-ms-docs-grouped-path:
    - /planner/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/progressTaskBoardFormat
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Get plannerProgressTaskBoardTaskFormat
      description: Retrieve the properties and relationships of plannerProgressTaskBoardTaskFormat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerprogresstaskboardtaskformat-get?view=graph-rest-1.0
      operationId: planner.tasks.GetProgressTaskBoardFormat
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Update plannerProgressTaskBoardTaskFormat
      description: Update the properties of plannerProgressTaskBoardTaskFormat object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerprogresstaskboardtaskformat-update?view=graph-rest-1.0
      operationId: planner.tasks.UpdateProgressTaskBoardFormat
      parameters:
      - name: If-Match
        in: header
        description: ETag value.
        required: true
        schema:
          type: string
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Delete navigation property progressTaskBoardFormat for planner
      operationId: planner.tasks.DeleteProgressTaskBoardFormat
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/tasks/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
      - planner.plannerTask
      summary: Microsoft Graph Get the number of the resource
      operationId: planner.tasks.GetCount-bfd2
      parameters:
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
components:
  schemas:
    microsoft.graph.plannerPreviewType:
      title: plannerPreviewType
      enum:
      - automatic
      - noPreview
      - checklist
      - description
      - reference
      type: string
    microsoft.graph.ODataErrors.ErrorDetails:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        target:
          type: string
          nullable: true
    microsoft.graph.plannerAssignedToTaskBoardTaskFormat:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerAssignedToTaskBoardTaskFormat
        required:
        - '@odata.type'
        type: object
        properties:
          orderHintsByAssignee:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerOrderHintsByAssignee'
            - type: object
              nullable: true
            description: Dictionary of hints used to order tasks on the AssignedTo view of the Task Board. The key of each entry is one of the users the task is assigned to and the value is the order hint. The format of each value is defined as outlined here.
          unassignedOrderHint:
            type: string
            description: Hint value used to order the task on the AssignedTo view of the Task Board when the task isn't assigned to anyone, or if the orderHintsByAssignee dictionary doesn't provide an order hint for the user the task is assigned to. The format is defined as outlined here.
            nullable: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
    ODataCountResponse:
      type: integer
      format: int32
    microsoft.graph.plannerChecklistItems:
      title: plannerChecklistItems
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.identity:
      title: identity
      required:
      - '@odata.type'
      type: object
      properties:
        displayName:
          type: string
          description: The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.
          nullable: true
        id:
          type: string
          description: Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.
          nullable: true
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.azureCommunicationServicesUserIdentity': '#/components/schemas/microsoft.graph.azureCommunicationServicesUserIdentity'
          '#microsoft.graph.communicationsApplicationIdentity': '#/components/schemas/microsoft.graph.communicationsApplicationIdentity'
          '#microsoft.graph.communicationsApplicationInstanceIdentity': '#/components/schemas/microsoft.graph.communicationsApplicationInstanceIdentity'
          '#microsoft.graph.communicationsEncryptedIdentity': '#/components/schemas/microsoft.graph.communicationsEncryptedIdentity'
          '#microsoft.graph.communicationsGuestIdentity': '#/components/schemas/microsoft.graph.communicationsGuestIdentity'
          '#microsoft.graph.communicationsPhoneIdentity': '#/components/schemas/microsoft.graph.communicationsPhoneIdentity'
          '#microsoft.graph.communicationsUserIdentity': '#/components/schemas/microsoft.graph.communicationsUserIdentity'
          '#microsoft.graph.emailIdentity': '#/components/schemas/microsoft.graph.emailIdentity'
          '#microsoft.graph.initiator': '#/components/schemas/microsoft.graph.initiator'
          '#microsoft.graph.provisionedIdentity': '#/components/schemas/microsoft.graph.provisionedIdentity'
          '#microsoft.graph.provisioningServicePrincipal': '#/components/schemas/microsoft.graph.provisioningServicePrincipal'
          '#microsoft.graph.provisioningSystem': '#/components/schemas/microsoft.graph.provisioningSystem'
          '#microsoft.graph.servicePrincipalIdentity': '#/components/schemas/microsoft.graph.servicePrincipalIdentity'
          '#microsoft.graph.sharePointIdentity': '#/components/schemas/microsoft.graph.sharePointIdentity'
          '#microsoft.graph.teamworkApplicationIdentity': '#/components/schemas/microsoft.graph.teamworkApplicationIdentity'
          '#microsoft.graph.teamworkConversationIdentity': '#/components/schemas/microsoft.graph.teamworkConversationIdentity'
          '#microsoft.graph.teamworkTagIdentity': '#/components/schemas/microsoft.graph.teamworkTagIdentity'
          '#microsoft.graph.teamworkUserIdentity': '#/components/schemas/microsoft.graph.teamworkUserIdentity'
          '#microsoft.graph.userIdentity': '#/components/schemas/microsoft.graph.userIdentity'
          '#microsoft.graph.callRecords.userIdentity': '#/components/schemas/microsoft.graph.callRecords.userIdentity'
    microsoft.graph.plannerProgressTaskBoardTaskFormat:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerProgressTaskBoardTaskFormat
        required:
        - '@odata.type'
        type: object
        properties:
          orderHint:
            type: string
            description: Hint value used to order the task on the progress view of the task board. For details about the supported format, see Using order hints in Planner.
            nullable: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerProgressTaskBoardTaskFormat'
    microsoft.graph.ODataErrors.InnerError:
      title: InnerError
      required:
      - '@odata.type'
      type: object
      properties:
        request-id:
          type: string
          description: Request Id as tracked internally by the service
          nullable: true
        client-request-id:
          type: string
          description: Client request Id as sent by the client application.
          nullable: true
        date:
          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 when the error occured.
          format: date-time
          nullable: true
        '@odata.type':
          type: string
    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

# --- truncated at 32 KB (165 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/microsoft-graph-planner-plannertask-api-openapi.yml