Microsoft Graph planner.plannerPlan API

openapi: 3.1.0
info:
  title: Microsoft Graph Admin Admin.admin planner.plannerPlan 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.plannerPlan
  x-ms-docs-toc-type: page
paths:
  /planner/plans:
    description: Provides operations to manage the plans property of the microsoft.graph.planner entity.
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph List plans
      description: Get a list of plannerPlan objects.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/planner-list-plans?view=graph-rest-1.0
      operationId: planner.ListPlans
      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.plannerPlanCollectionResponse'
        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.plannerPlan
      summary: Microsoft Graph Create plannerPlan
      description: Create a new plannerPlan object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/planner-post-plans?view=graph-rest-1.0
      operationId: planner.CreatePlans
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerPlan'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerPlan'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/plans/{plannerPlan-id}:
    description: Provides operations to manage the plans property of the microsoft.graph.planner entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get plannerPlan
      description: Retrieve the properties and relationships of a plannerplan object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerplan-get?view=graph-rest-1.0
      operationId: planner.GetPlans
      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.plannerPlan'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Update plannerPlan
      description: Update the properties of a plannerPlan object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerplan-update?view=graph-rest-1.0
      operationId: planner.UpdatePlans
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerPlan'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerPlan'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Delete plannerPlan
      description: Delete a plannerPlan object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerplan-delete?view=graph-rest-1.0
      operationId: planner.DeletePlans
      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/plans/{plannerPlan-id}/buckets:
    description: Provides operations to manage the buckets property of the microsoft.graph.plannerPlan entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph List buckets
      description: Retrieve a list of plannerBucket objects contained by a plannerPlan object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerplan-list-buckets?view=graph-rest-1.0
      operationId: planner.plans.ListBuckets
      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.plannerBucketCollectionResponse'
        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.plannerPlan
      summary: Microsoft Graph Create new navigation property to buckets for planner
      operationId: planner.plans.CreateBuckets
      requestBody:
        description: New navigation property
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerBucket'
        required: true
      responses:
        2XX:
          description: Created navigation property.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerBucket'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}:
    description: Provides operations to manage the buckets property of the microsoft.graph.plannerPlan entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get buckets from planner
      description: Read-only. Nullable. Collection of buckets in the plan.
      operationId: planner.plans.GetBuckets
      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.plannerBucket'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Update the navigation property buckets in planner
      operationId: planner.plans.UpdateBuckets
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.plannerBucket'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.plannerBucket'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Delete navigation property buckets for planner
      operationId: planner.plans.DeleteBuckets
      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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks:
    description: Provides operations to manage the tasks property of the microsoft.graph.plannerBucket entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    x-ms-docs-grouped-path:
    - /planner/buckets/{plannerBucket-id}/tasks
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get tasks from planner
      description: Read-only. Nullable. The collection of tasks in the bucket.
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Create new navigation property to tasks for planner
      operationId: planner.plans.buckets.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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}:
    description: Provides operations to manage the tasks property of the microsoft.graph.plannerBucket entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    - 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}
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get tasks from planner
      description: Read-only. Nullable. The collection of tasks in the bucket.
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Update the navigation property tasks in planner
      operationId: planner.plans.buckets.UpdateTasks
      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.plannerPlan
      summary: Microsoft Graph Delete navigation property tasks for planner
      operationId: planner.plans.buckets.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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat:
    description: Provides operations to manage the assignedToTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    - 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}/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    - /planner/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get assignedToTaskBoardFormat from planner
      description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Update the navigation property assignedToTaskBoardFormat in planner
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Delete navigation property assignedToTaskBoardFormat for planner
      operationId: planner.plans.buckets.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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat:
    description: Provides operations to manage the bucketTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    - 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}/tasks/{plannerTask-id}/bucketTaskBoardFormat
    - /planner/tasks/{plannerTask-id}/bucketTaskBoardFormat
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get bucketTaskBoardFormat from planner
      description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Update the navigation property bucketTaskBoardFormat in planner
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Delete navigation property bucketTaskBoardFormat for planner
      operationId: planner.plans.buckets.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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/details:
    description: Provides operations to manage the details property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    - 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}/tasks/{plannerTask-id}/details
    - /planner/tasks/{plannerTask-id}/details
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get details from planner
      description: Read-only. Nullable. More details about the task.
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Update the navigation property details in planner
      operationId: planner.plans.buckets.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.plannerPlan
      summary: Microsoft Graph Delete navigation property details for planner
      operationId: planner.plans.buckets.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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat:
    description: Provides operations to manage the progressTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - name: plannerPlan-id
      in: path
      description: The unique identifier of plannerPlan
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerPlan
    - name: plannerBucket-id
      in: path
      description: The unique identifier of plannerBucket
      required: true
      schema:
        type: string
      x-ms-docs-key-type: plannerBucket
    - 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}/tasks/{plannerTask-id}/progressTaskBoardFormat
    - /planner/tasks/{plannerTask-id}/progressTaskBoardFormat
    get:
      tags:
      - planner.plannerPlan
      summary: Microsoft Graph Get progressTaskBoardFormat from planner
      description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
      operationId: planner.plans.buckets.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/response

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