Microsoft Graph Planner.planner API

The Planner.planner API from Microsoft Graph — 1 operation(s) for planner.planner.

Operations 2

GET /planner Microsoft Graph Get planner #
PATCH /planner Microsoft Graph Update planner #

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/admin?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreementacceptance?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreement?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teamsapp?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/application?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/applicationtemplate?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/azure-ad-auditlog-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/authenticationmethodconfiguration?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/authenticationmethodspolicy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/certificatebasedauthconfiguration?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/chat?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/communications-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/complianceapioverview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/externalconnectors-externalconnection?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contact?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contract?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/copilot-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/datapolicyoperation?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/intune-apps-conceptual?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/intune-device-conceptual?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/device?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/domaindnsrecord?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/domain?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/drive?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/education-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/employee-experience-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/externalconnectors-external?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/filter-query-parameter
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/excel?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/grouplifecyclepolicy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groupsetting?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groupsettingtemplate?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/identitycontainer?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/informationprotection?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/invitation?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/users?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/oauth2permissiongrant?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/organization?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/resourcespecificpermissiongrant?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/place?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/planner-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/print?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/privacy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/report?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/rolemanagement?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/schemaextension?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/scopedrolemembership?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/search-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/security-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/serviceprincipal?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/shares?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/sharepoint?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/solutions-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/filestorage?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/subscribedsku?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teamwork?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/tenantrelationship?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/auth/auth-concepts
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/workplace?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/sitepage?view=graph-rest-1.0

Specifications

Other Resources

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-graph-planner-planner-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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

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

OpenAPI Specification

microsoft-graph-planner-planner-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Microsoft Graph Admin Admin.admin Planner.planner 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.planner
  x-ms-docs-toc-type: page
paths:
  /planner:
    description: Provides operations to manage the planner singleton.
    get:
      tags:
      - Planner.planner
      summary: Microsoft Graph Get planner
      operationId: planner.planner.GetPlanner
      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 entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.planner'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - Planner.planner
      summary: Microsoft Graph Update planner
      operationId: planner.planner.UpdatePlanner
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.planner'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.planner'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
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'
    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.plannerCategoryDescriptions:
      title: plannerCategoryDescriptions
      required:
      - '@odata.type'
      type: object
      properties:
        category1:
          type: string
          description: The label associated with Category 1
          nullable: true
        category10:
          type: string
          description: The label associated with Category 10
          nullable: true
        category11:
          type: string
          description: The label associated with Category 11
          nullable: true
        category12:
          type: string
          description: The label associated with Category 12
          nullable: true
        category13:
          type: string
          description: The label associated with Category 13
          nullable: true
        category14:
          type: string
          description: The label associated with Category 14
          nullable: true
        category15:
          type: string
          description: The label associated with Category 15
          nullable: true
        category16:
          type: string
          description: The label associated with Category 16
          nullable: true
        category17:
          type: string
          description: The label associated with Category 17
          nullable: true
        category18:
          type: string
          description: The label associated with Category 18
          nullable: true
        category19:
          type: string
          description: The label associated with Category 19
          nullable: true
        category2:
          type: string
          description: The label associated with Category 2
          nullable: true
        category20:
          type: string
          description: The label associated with Category 20
          nullable: true
        category21:
          type: string
          description: The label associated with Category 21
          nullable: true
        category22:
          type: string
          description: The label associated with Category 22
          nullable: true
        category23:
          type: string
          description: The label associated with Category 23
          nullable: true
        category24:
          type: string
          description: The label associated with Category 24
          nullable: true
        category25:
          type: string
          description: The label associated with Category 25
          nullable: true
        category3:
          type: string
          description: The label associated with Category 3
          nullable: true
        category4:
          type: string
          description: The label associated with Category 4
          nullable: true
        category5:
          type: string
          description: The label associated with Category 5
          nullable: true
        category6:
          type: string
          description: The label associated with Category 6
          nullable: true
        category7:
          type: string
          description: The label associated with Category 7
          nullable: true
        category8:
          type: string
          description: The label associated with Category 8
          nullable: true
        category9:
          type: string
          description: The label associated with Category 9
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.plannerChecklistItems:
      title: plannerChecklistItems
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.planner:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: planner
        required:
        - '@odata.type'
        type: object
        properties:
          buckets:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.plannerBucket'
            description: Read-only. Nullable. Returns a collection of the specified buckets
            x-ms-navigationProperty: true
          plans:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.plannerPlan'
            description: Read-only. Nullable. Returns a collection of the specified plans
            x-ms-navigationProperty: true
          tasks:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.plannerTask'
            description: Read-only. Nullable. Returns a collection of the specified tasks
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.planner'
    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.plannerUserIds:
      title: plannerUserIds
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    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.plannerPlanDetails:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerPlanDetails
        required:
        - '@odata.type'
        type: object
        properties:
          categoryDescriptions:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerCategoryDescriptions'
            - type: object
              nullable: true
            description: An object that specifies the descriptions of the 25 categories that can be associated with tasks in the plan.
          sharedWith:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerUserIds'
            - type: object
              nullable: true
            description: Set of user IDs that this plan is shared with. If you're using Microsoft 365 groups, use the Groups API to manage group membership to share the group's plan. You can also add existing members of the group to this collection, although it isn't required for them to access the plan owned by the group.
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerPlanDetails'
    microsoft.graph.plannerContainerType:
      title: plannerContainerType
      enum:
      - group
      - unknownFutureValue
      - roster
      type: string
    microsoft.graph.plannerPlan:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerPlan
        required:
        - '@odata.type'
        type: object
        properties:
          container:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerPlanContainer'
            - type: object
              nullable: true
            description: Identifies the container of the plan. Specify only the url, the containerId and type, or all properties. After it's set, this property can’t be updated. Required.
          createdBy:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identitySet'
            - type: object
              nullable: true
            description: Read-only. The user who created the plan.
          createdDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Read-only. Date and time at which the plan is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
            format: date-time
            nullable: true
          owner:
            type: string
            description: Use the container property instead. ID of the group that owns the plan. After it's set, this property can’t be updated. This property won't return a valid group ID if the container of the plan isn't a group.
            nullable: true
          title:
            type: string
            description: Required. Title of the plan.
          buckets:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.plannerBucket'
            description: Read-only. Nullable. Collection of buckets in the plan.
            x-ms-navigationProperty: true
          details:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
            - type: object
              nullable: true
            description: Read-only. Nullable. Extra details about the plan.
            x-ms-navigationProperty: true
          tasks:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.plannerTask'
            description: Read-only. Nullable. Collection of tasks in the plan.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerPlan'
    microsoft.graph.plannerTask:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerTask
        required:
        - '@odata.type'
        type: object
        properties:
          activeChecklistItemCount:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: Number of checklist items with value set to false, representing incomplete items.
            format: int32
            nullable: true
          appliedCategories:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerAppliedCategories'
            - type: object
              nullable: true
            description: The categories to which the task has been applied. See applied Categories for possible values.
          assigneePriority:
            type: string
            description: Hint used to order items of this type in a list view. The format is defined as outlined here.
            nullable: true
          assignments:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerAssignments'
            - type: object
              nullable: true
            description: The set of assignees the task is assigned to.
          bucketId:
            type: string
            description: Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It's 28 characters long and case-sensitive. Format validation is done on the service.
            nullable: true
          checklistItemCount:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: Number of checklist items that are present on the task.
            format: int32
            nullable: true
          completedBy:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identitySet'
            - type: object
              nullable: true
            description: Identity of the user that completed the task.
          completedDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
            format: date-time
            nullable: true
          conversationThreadId:
            type: string
            description: Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.
            nullable: true
          createdBy:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.identitySet'
            - type: object
              nullable: true
            description: Identity of the user that created the task.
          createdDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
            format: date-time
            nullable: true
          dueDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
            format: date-time
            nullable: true
          hasDescription:
            type: boolean
            description: Read-only. Value is true if the details object of the task has a nonempty description and false otherwise.
            nullable: true
          orderHint:
            type: string
            description: Hint used to order items of this type in a list view. The format is defined as outlined here.
            nullable: true
          percentComplete:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: Percentage of task completion. When set to 100, the task is considered completed.
            format: int32
            nullable: true
          planId:
            type: string
            description: Plan ID to which the task belongs.
            nullable: true
          previewType:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerPreviewType'
            - type: object
              nullable: true
            description: 'This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist, description, reference.'
          priority:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: Priority of the task. The valid range of values is between 0 and 10, with the increasing value being lower priority (0 has the highest priority and 10 has the lowest priority).  Currently, Planner interprets values 0 and 1 as 'urgent', 2, 3 and 4 as 'important', 5, 6, and 7 as 'medium', and 8, 9, and 10 as 'low'.  Additionally, Planner sets the value 1 for 'urgent', 3 for 'important', 5 for 'medium', and 9 for 'low'.
            format: int32
            nullable: true
          referenceCount:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: Number of external references that exist on the task.
            format: int32
            nullable: true
          startDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
            format: date-time
            nullable: true
          title:
            type: string
            description: Title of the task.
          assignedToTaskBoardFormat:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
            - type: object
              nullable: true
            description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
            x-ms-navigationProperty: true
          bucketTaskBoardFormat:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
            - type: object
              nullable: true
            description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
            x-ms-navigationProperty: true
          details:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
            - type: object
              nullable: true
            description: Read-only. Nullable. More details about the task.
            x-ms-navigationProperty: true
          progressTaskBoardFormat:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
            - type: object
              nullable: true
            description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerTask'
    microsoft.graph.plannerTaskDetails:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerTaskDetails
        required:
        - '@odata.type'
        type: object
        properties:
          checklist:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerChecklistItems'
            - type: object
              nullable: true
            description: The collection of checklist items on the task.
          description:
            type: string
            description: Description of the task.
            nullable: true
          previewType:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerPreviewType'
            - type: object
              nullable: true
            description: 'This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist, description, reference. When set to automatic the displayed preview is chosen by the app viewing the task.'
          references:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.plannerExternalReferences'
            - type: object
              nullable: true
            description: The collection of references on the task.
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.plannerTaskDetails'
    microsoft.graph.ODataErrors.MainError:
      required:
      - code
      - message
      type: object
      properties:
        code:
          type: string
        message:
          type: string
          x-ms-primary-error-message: true
        target:
          type: string
          nullable: true
        details:
          type: array
          items:
            $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails'
        innerError:
          $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError'
    microsoft.graph.plannerAppliedCategories:
      title: plannerAppliedCategories
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.plannerBucketTaskBoardTaskFormat:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: plannerBucketTaskBoardTaskFormat
        required:
        - '@odata.type'
        type: object
        properties:
          orderHint:
            type: string
            description: Hint used to order tasks in the bucket 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.plannerBucketTaskBoardTaskFormat'
    microsoft.graph.plannerOrderHintsByAssignee:
      title: plannerOrderHintsByAssignee
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.plannerAssignments:
      title: plannerAssignments
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.plannerExternalReferences:
      title: plannerExternalReferences
      required:
      - '@odata.type'
      type: object
      properties:
        '@odata.type':
          type: string
    microsoft.graph.plannerPlanContainer:
      title: plannerPlanContainer
      required:
      - '@odata.type'
      type: object
      properties:
        containerId:
          type: string
          description: The identifier of the resource that contains the plan. Optional.
          nullable: true
        type:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.plannerContainerType'
          - type: object
            nullable: true
          description: 'The type of the resource that contains the plan. For supported types, see the previous table. The possible values are: group, unknownFutureValue, roster. Use the Prefer: include-unknown-enum-members request header to get the following members in this evolvable enum: roster. Optional.'
        url:
          type: string
          description: The full canonical URL of the container. Optional.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.ODataErrors.ODataError:
      required:
      - error
      type: object
      properties:
        error:
          $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError'
    microsoft.graph.identitySet:
      title: identitySet
      required:
      - '@odata.type'
      type: object
      properties:
        application:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.identity'
          - type: object
            nullable: true
          description: Optional. The application associated with this action.
        device:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.identity'
          - type: object
            nullable: true
          description: Optional. The device associated with this action.
        user:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.identity'
          - type: object
            nullable: true
          description: Optional. The user associated with this action.
        '@odata.type':
          type: string
      discriminator:
        propertyName: '@odata.type'
        mapping:
          '#microsoft.graph.aiInteractionMentionedIdentitySet': '#/components/schemas/microso

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