Microsoft Graph planner.plannerBucket API

openapi: 3.1.0
info:
  title: Microsoft Graph Admin Admin.admin planner.plannerBucket 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.plannerBucket
  x-ms-docs-toc-type: page
paths:
  /planner/buckets:
    description: Provides operations to manage the buckets property of the microsoft.graph.planner entity.
    get:
      tags:
      - planner.plannerBucket
      summary: Microsoft Graph List buckets
      description: Retrieve a list of plannerbucket objects.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/planner-list-buckets?view=graph-rest-1.0
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Create plannerBucket
      description: Create a new plannerBucket object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/planner-post-buckets?view=graph-rest-1.0
      operationId: planner.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/buckets/{plannerBucket-id}:
    description: Provides operations to manage the buckets property of the microsoft.graph.planner entity.
    parameters:
    - 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.plannerBucket
      summary: Microsoft Graph Get plannerBucket
      description: Retrieve the properties and relationships of a plannerBucket object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerbucket-get?view=graph-rest-1.0
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Update plannerbucket
      description: Update the properties of plannerbucket object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerbucket-update?view=graph-rest-1.0
      operationId: planner.UpdateBuckets
      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.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.plannerBucket
      summary: Microsoft Graph Delete plannerBucket
      description: Delete plannerBucket.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerbucket-delete?view=graph-rest-1.0
      operationId: planner.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/buckets/{plannerBucket-id}/tasks:
    description: Provides operations to manage the tasks property of the microsoft.graph.plannerBucket entity.
    parameters:
    - 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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks
    get:
      tags:
      - planner.plannerBucket
      summary: Microsoft Graph List tasks
      description: Retrieve a list of plannerTask objects associated to a plannerBucket object.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/plannerbucket-list-tasks?view=graph-rest-1.0
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Create new navigation property to tasks for planner
      operationId: planner.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/buckets/{plannerBucket-id}/tasks/{plannerTask-id}:
    description: Provides operations to manage the tasks property of the microsoft.graph.plannerBucket entity.
    parameters:
    - 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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}
    get:
      tags:
      - planner.plannerBucket
      summary: Microsoft Graph Get tasks from planner
      description: Read-only. Nullable. The collection of tasks in the bucket.
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Update the navigation property tasks in planner
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Delete navigation property tasks for planner
      operationId: planner.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/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat:
    description: Provides operations to manage the assignedToTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - 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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    - /planner/tasks/{plannerTask-id}/assignedToTaskBoardFormat
    get:
      tags:
      - planner.plannerBucket
      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.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.plannerBucket
      summary: Microsoft Graph Update the navigation property assignedToTaskBoardFormat in planner
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Delete navigation property assignedToTaskBoardFormat for planner
      operationId: planner.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/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat:
    description: Provides operations to manage the bucketTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - 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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat
    - /planner/tasks/{plannerTask-id}/bucketTaskBoardFormat
    get:
      tags:
      - planner.plannerBucket
      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.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.plannerBucket
      summary: Microsoft Graph Update the navigation property bucketTaskBoardFormat in planner
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Delete navigation property bucketTaskBoardFormat for planner
      operationId: planner.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/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/details:
    description: Provides operations to manage the details property of the microsoft.graph.plannerTask entity.
    parameters:
    - 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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/details
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/details
    - /planner/tasks/{plannerTask-id}/details
    get:
      tags:
      - planner.plannerBucket
      summary: Microsoft Graph Get details from planner
      description: Read-only. Nullable. More details about the task.
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Update the navigation property details in planner
      operationId: planner.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.plannerBucket
      summary: Microsoft Graph Delete navigation property details for planner
      operationId: planner.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/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat:
    description: Provides operations to manage the progressTaskBoardFormat property of the microsoft.graph.plannerTask entity.
    parameters:
    - 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/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat
    - /planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/progressTaskBoardFormat
    - /planner/tasks/{plannerTask-id}/progressTaskBoardFormat
    get:
      tags:
      - planner.plannerBucket
      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.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/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - planner.plannerBucket
      summary: Microsoft Graph Update the navigation property progressTaskBoardFormat in planner
      operationId: planner.buckets.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.plannerBucket
      summary: Microsoft Graph Delete navigation property progressTaskBoardFormat for planner
      operationId: planner.buckets.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/buckets/{plannerBucket-id}/tasks/$count:
    description: Provides operations to count the resources in the collection.
    parameters:
    - 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.plannerBucket
      summary: Microsoft Graph Get the number of the resource
      operationId: planner.buckets.tasks.GetCount-145a
      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'
  /planner/buckets/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
      - planner.plannerBucket
      summary: Microsoft Graph Get the number of the resource
      operationId: planner.buckets.GetCount-9ddb
      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:
  responses:
    ODataCountResponse:
      description: The count of the resource
      content:
        text/plain:
          schema:
            $ref: '#/components/schemas/ODataCountResponse'
    microsoft.graph.plannerBucketCollectionResponse:
      description: Retrieved collection
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/microsoft.graph.plannerBucketCollectionResponse'
    microsoft.graph.plannerTaskCollectionResponse:
      description: Retrieved collection
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/microsoft.graph.plannerTaskCollectionResponse'
    error:
      description: error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError'
  schemas:
    microsoft.graph.plannerPreviewType:
      title: plannerPreviewType
      enum:
      - automatic
      - noPreview
      - checklist
      - description
      - reference
      type: string
    microsoft.graph.plannerChecklistItems:
      title: plannerChecklistItems
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.plannerBucket:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerBucket
        required:
        - '@odata.type'
        type: object
        properties:
          name:
            type: string
            description: Name of the bucket.
          orderHint:
            type: string
            description: Hint used to order items of this type in a list view. For details about the supported format, see Using order hints in Planner.
            nullable: true
          planId:
            type: string
            description: Plan ID to which the bucket belongs.
            nullable: true
          tasks:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.plannerTask'
            description: Read-only. Nullable. The collection of tasks in the bucket.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerBucket'
    microsoft.graph.entity:
      title: entity
      required:
      - '@odata.type'
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for an entity. Read-only.
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.accessPackage': '#/components/schemas/microsoft.graph.accessPackage'
          '#microsoft.graph.accessPackageAssignment': '#/components/schemas/microsoft.graph.accessPackageAssignment'
          '#microsoft.graph.accessPackageAssignmentPolicy': '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
          '#microsoft.graph.accessPackageAssignmentRequest': '#/components/schemas/microsoft.graph.accessPackageAssignmentRequest'
          '#microsoft.graph.accessPackageCatalog': '#/components/schemas/microsoft.graph.accessPackageCatalog'
          '#microsoft.graph.accessPackageQuestion': '#/components/schemas/microsoft.graph.accessPackageQuestion'
          '#microsoft.graph.accessPackageMultipleChoiceQuestion': '#/components/schemas/microsoft.graph.accessPackageMultipleChoiceQuestion'
          '#microsoft.graph.accessPackageTextInputQuestion': '#/components/schemas/microsoft.graph.a

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