naftiko: 1.0.0-alpha2
info:
  label: Microsoft Graph Planner — planner.plannerTask
  description: 'Microsoft Graph Planner — planner.plannerTask. 18 operations. Lead operation: Microsoft Graph List plannerTask
    objects. Self-contained Naftiko capability covering one Microsoft Graph business surface.'
  tags:
  - Microsoft Graph
  - planner.plannerTask
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_GRAPH_API_KEY: MICROSOFT_GRAPH_API_KEY
capability:
  consumes:
  - type: http
    namespace: planner-planner-plannertask
    baseUri: ''
    description: Microsoft Graph Planner — planner.plannerTask business capability. Self-contained, no shared references.
    resources:
    - name: planner-tasks
      path: /planner/tasks
      operations:
      - name: plannerlisttasks
        method: GET
        description: Microsoft Graph List plannerTask objects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $orderby
          in: query
          type: array
          description: Order items by property values
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: plannercreatetasks
        method: POST
        description: Microsoft Graph Create plannerTask
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: planner-tasks-$count
      path: /planner/tasks/$count
      operations:
      - name: plannertasksgetcountbfd2
        method: GET
        description: Microsoft Graph Get the number of the resource
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: planner-tasks-plannerTask-id
      path: /planner/tasks/{plannerTask-id}
      operations:
      - name: plannergettasks
        method: GET
        description: Microsoft Graph Get plannerTask
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: plannerupdatetasks
        method: PATCH
        description: Microsoft Graph Update plannerTask
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag value.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: plannerdeletetasks
        method: DELETE
        description: Microsoft Graph Delete plannerTask
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
    - name: planner-tasks-plannerTask-id-assignedToTaskBoardFormat
      path: /planner/tasks/{plannerTask-id}/assignedToTaskBoardFormat
      operations:
      - name: plannertasksgetassignedtotaskboardformat
        method: GET
        description: Microsoft Graph Get plannerAssignedToTaskBoardTaskFormat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: plannertasksupdateassignedtotaskboardformat
        method: PATCH
        description: Microsoft Graph Update plannerAssignedToTaskBoardTaskFormat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag value.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: plannertasksdeleteassignedtotaskboardformat
        method: DELETE
        description: Microsoft Graph Delete navigation property assignedToTaskBoardFormat for planner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
    - name: planner-tasks-plannerTask-id-bucketTaskBoardFormat
      path: /planner/tasks/{plannerTask-id}/bucketTaskBoardFormat
      operations:
      - name: plannertasksgetbuckettaskboardformat
        method: GET
        description: Microsoft Graph Get plannerBucketTaskBoardTaskFormat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: plannertasksupdatebuckettaskboardformat
        method: PATCH
        description: Microsoft Graph Update plannerBucketTaskBoardTaskFormat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag value.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: plannertasksdeletebuckettaskboardformat
        method: DELETE
        description: Microsoft Graph Delete navigation property bucketTaskBoardFormat for planner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
    - name: planner-tasks-plannerTask-id-details
      path: /planner/tasks/{plannerTask-id}/details
      operations:
      - name: plannertasksgetdetails
        method: GET
        description: Microsoft Graph Get plannerTaskDetails
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: plannertasksupdatedetails
        method: PATCH
        description: Microsoft Graph Update plannertaskdetails
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag value.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: plannertasksdeletedetails
        method: DELETE
        description: Microsoft Graph Delete navigation property details for planner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
    - name: planner-tasks-plannerTask-id-progressTaskBoardFormat
      path: /planner/tasks/{plannerTask-id}/progressTaskBoardFormat
      operations:
      - name: plannertasksgetprogresstaskboardformat
        method: GET
        description: Microsoft Graph Get plannerProgressTaskBoardTaskFormat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $select
          in: query
          type: array
          description: Select properties to be returned
        - name: $expand
          in: query
          type: array
          description: Expand related entities
      - name: plannertasksupdateprogresstaskboardformat
        method: PATCH
        description: Microsoft Graph Update plannerProgressTaskBoardTaskFormat
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag value.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: plannertasksdeleteprogresstaskboardformat
        method: DELETE
        description: Microsoft Graph Delete navigation property progressTaskBoardFormat for planner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: ETag
  exposes:
  - type: rest
    namespace: planner-planner-plannertask-rest
    port: 8080
    description: REST adapter for Microsoft Graph Planner — planner.plannerTask. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/planner/tasks
      name: planner-tasks
      description: REST surface for planner-tasks.
      operations:
      - method: GET
        name: plannerlisttasks
        description: Microsoft Graph List plannerTask objects
        call: planner-planner-plannertask.plannerlisttasks
        with:
          $orderby: rest.$orderby
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: plannercreatetasks
        description: Microsoft Graph Create plannerTask
        call: planner-planner-plannertask.plannercreatetasks
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planner/tasks/count
      name: planner-tasks-count
      description: REST surface for planner-tasks-$count.
      operations:
      - method: GET
        name: plannertasksgetcountbfd2
        description: Microsoft Graph Get the number of the resource
        call: planner-planner-plannertask.plannertasksgetcountbfd2
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planner/tasks/{plannertask-id}
      name: planner-tasks-plannertask-id
      description: REST surface for planner-tasks-plannerTask-id.
      operations:
      - method: GET
        name: plannergettasks
        description: Microsoft Graph Get plannerTask
        call: planner-planner-plannertask.plannergettasks
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: plannerupdatetasks
        description: Microsoft Graph Update plannerTask
        call: planner-planner-plannertask.plannerupdatetasks
        with:
          If-Match: rest.If-Match
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: plannerdeletetasks
        description: Microsoft Graph Delete plannerTask
        call: planner-planner-plannertask.plannerdeletetasks
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planner/tasks/{plannertask-id}/assignedtotaskboardformat
      name: planner-tasks-plannertask-id-assignedtotaskboardformat
      description: REST surface for planner-tasks-plannerTask-id-assignedToTaskBoardFormat.
      operations:
      - method: GET
        name: plannertasksgetassignedtotaskboardformat
        description: Microsoft Graph Get plannerAssignedToTaskBoardTaskFormat
        call: planner-planner-plannertask.plannertasksgetassignedtotaskboardformat
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: plannertasksupdateassignedtotaskboardformat
        description: Microsoft Graph Update plannerAssignedToTaskBoardTaskFormat
        call: planner-planner-plannertask.plannertasksupdateassignedtotaskboardformat
        with:
          If-Match: rest.If-Match
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: plannertasksdeleteassignedtotaskboardformat
        description: Microsoft Graph Delete navigation property assignedToTaskBoardFormat for planner
        call: planner-planner-plannertask.plannertasksdeleteassignedtotaskboardformat
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planner/tasks/{plannertask-id}/buckettaskboardformat
      name: planner-tasks-plannertask-id-buckettaskboardformat
      description: REST surface for planner-tasks-plannerTask-id-bucketTaskBoardFormat.
      operations:
      - method: GET
        name: plannertasksgetbuckettaskboardformat
        description: Microsoft Graph Get plannerBucketTaskBoardTaskFormat
        call: planner-planner-plannertask.plannertasksgetbuckettaskboardformat
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: plannertasksupdatebuckettaskboardformat
        description: Microsoft Graph Update plannerBucketTaskBoardTaskFormat
        call: planner-planner-plannertask.plannertasksupdatebuckettaskboardformat
        with:
          If-Match: rest.If-Match
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: plannertasksdeletebuckettaskboardformat
        description: Microsoft Graph Delete navigation property bucketTaskBoardFormat for planner
        call: planner-planner-plannertask.plannertasksdeletebuckettaskboardformat
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planner/tasks/{plannertask-id}/details
      name: planner-tasks-plannertask-id-details
      description: REST surface for planner-tasks-plannerTask-id-details.
      operations:
      - method: GET
        name: plannertasksgetdetails
        description: Microsoft Graph Get plannerTaskDetails
        call: planner-planner-plannertask.plannertasksgetdetails
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: plannertasksupdatedetails
        description: Microsoft Graph Update plannertaskdetails
        call: planner-planner-plannertask.plannertasksupdatedetails
        with:
          If-Match: rest.If-Match
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: plannertasksdeletedetails
        description: Microsoft Graph Delete navigation property details for planner
        call: planner-planner-plannertask.plannertasksdeletedetails
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/planner/tasks/{plannertask-id}/progresstaskboardformat
      name: planner-tasks-plannertask-id-progresstaskboardformat
      description: REST surface for planner-tasks-plannerTask-id-progressTaskBoardFormat.
      operations:
      - method: GET
        name: plannertasksgetprogresstaskboardformat
        description: Microsoft Graph Get plannerProgressTaskBoardTaskFormat
        call: planner-planner-plannertask.plannertasksgetprogresstaskboardformat
        with:
          $select: rest.$select
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: plannertasksupdateprogresstaskboardformat
        description: Microsoft Graph Update plannerProgressTaskBoardTaskFormat
        call: planner-planner-plannertask.plannertasksupdateprogresstaskboardformat
        with:
          If-Match: rest.If-Match
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: plannertasksdeleteprogresstaskboardformat
        description: Microsoft Graph Delete navigation property progressTaskBoardFormat for planner
        call: planner-planner-plannertask.plannertasksdeleteprogresstaskboardformat
        with:
          If-Match: rest.If-Match
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: planner-planner-plannertask-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Graph Planner — planner.plannerTask. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: microsoft-graph-list-plannertask-objects
      description: Microsoft Graph List plannerTask objects
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannerlisttasks
      with:
        $orderby: tools.$orderby
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-create-plannertask
      description: Microsoft Graph Create plannerTask
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: planner-planner-plannertask.plannercreatetasks
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-number-resource
      description: Microsoft Graph Get the number of the resource
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksgetcountbfd2
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-plannertask
      description: Microsoft Graph Get plannerTask
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannergettasks
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-plannertask
      description: Microsoft Graph Update plannerTask
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannerupdatetasks
      with:
        If-Match: tools.If-Match
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-plannertask
      description: Microsoft Graph Delete plannerTask
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: planner-planner-plannertask.plannerdeletetasks
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-plannerassignedtotaskboardtaskformat
      description: Microsoft Graph Get plannerAssignedToTaskBoardTaskFormat
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksgetassignedtotaskboardformat
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-plannerassignedtotaskboardtaskformat
      description: Microsoft Graph Update plannerAssignedToTaskBoardTaskFormat
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksupdateassignedtotaskboardformat
      with:
        If-Match: tools.If-Match
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property
      description: Microsoft Graph Delete navigation property assignedToTaskBoardFormat for planner
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: planner-planner-plannertask.plannertasksdeleteassignedtotaskboardformat
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-plannerbuckettaskboardtaskformat
      description: Microsoft Graph Get plannerBucketTaskBoardTaskFormat
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksgetbuckettaskboardformat
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-plannerbuckettaskboardtaskformat
      description: Microsoft Graph Update plannerBucketTaskBoardTaskFormat
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksupdatebuckettaskboardformat
      with:
        If-Match: tools.If-Match
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property-2
      description: Microsoft Graph Delete navigation property bucketTaskBoardFormat for planner
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: planner-planner-plannertask.plannertasksdeletebuckettaskboardformat
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-plannertaskdetails
      description: Microsoft Graph Get plannerTaskDetails
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksgetdetails
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-plannertaskdetails
      description: Microsoft Graph Update plannertaskdetails
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksupdatedetails
      with:
        If-Match: tools.If-Match
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property-3
      description: Microsoft Graph Delete navigation property details for planner
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: planner-planner-plannertask.plannertasksdeletedetails
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-get-plannerprogresstaskboardtaskformat
      description: Microsoft Graph Get plannerProgressTaskBoardTaskFormat
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksgetprogresstaskboardformat
      with:
        $select: tools.$select
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-update-plannerprogresstaskboardtaskformat
      description: Microsoft Graph Update plannerProgressTaskBoardTaskFormat
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: planner-planner-plannertask.plannertasksupdateprogresstaskboardformat
      with:
        If-Match: tools.If-Match
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-graph-delete-navigation-property-4
      description: Microsoft Graph Delete navigation property progressTaskBoardFormat for planner
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: planner-planner-plannertask.plannertasksdeleteprogresstaskboardformat
      with:
        If-Match: tools.If-Match
      outputParameters:
      - type: object
        mapping: $.