Autodesk BIM 360 API — Issues

naftiko: 1.0.0-alpha2
info:
  label: Autodesk BIM 360 API — Issues
  description: 'Autodesk BIM 360 API — Issues. 7 operations. Lead operation: Autodesk List Issue Types. Self-contained Naftiko
    capability covering one Autodesk business surface.'
  tags:
  - Autodesk
  - Issues
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AUTODESK_API_KEY: AUTODESK_API_KEY
capability:
  consumes:
  - type: http
    namespace: bim360-issues
    baseUri: https://developer.api.autodesk.com
    description: Autodesk BIM 360 API — Issues business capability. Self-contained, no shared references.
    resources:
    - name: issues-v1-containers-containerId-issue-types
      path: /issues/v1/containers/{containerId}/issue-types
      operations:
      - name: getissuetypes
        method: GET
        description: Autodesk List Issue Types
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          required: true
    - name: issues-v1-containers-containerId-quality-issues
      path: /issues/v1/containers/{containerId}/quality-issues
      operations:
      - name: getissues
        method: GET
        description: Autodesk List Issues
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          description: The issues container ID for the project.
          required: true
        - name: filter[status]
          in: query
          type: string
        - name: filter[assigned_to]
          in: query
          type: string
        - name: filter[due_date]
          in: query
          type: string
        - name: filter[created_at]
          in: query
          type: string
        - name: filter[target_urn]
          in: query
          type: string
        - name: page[limit]
          in: query
          type: integer
        - name: page[offset]
          in: query
          type: integer
      - name: createissue
        method: POST
        description: Autodesk Create Issue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: issues-v1-containers-containerId-quality-issues-issueId
      path: /issues/v1/containers/{containerId}/quality-issues/{issueId}
      operations:
      - name: getissue
        method: GET
        description: Autodesk Get Issue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          required: true
        - name: issueId
          in: path
          type: string
          required: true
      - name: updateissue
        method: PATCH
        description: Autodesk Update Issue
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          required: true
        - name: issueId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: issues-v1-containers-containerId-quality-issues-issueId-comments
      path: /issues/v1/containers/{containerId}/quality-issues/{issueId}/comments
      operations:
      - name: getissuecomments
        method: GET
        description: Autodesk List Issue Comments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          required: true
        - name: issueId
          in: path
          type: string
          required: true
      - name: createissuecomment
        method: POST
        description: Autodesk Create Issue Comment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: containerId
          in: path
          type: string
          required: true
        - name: issueId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.AUTODESK_API_KEY}}'
  exposes:
  - type: rest
    namespace: bim360-issues-rest
    port: 8080
    description: REST adapter for Autodesk BIM 360 API — Issues. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/issues/v1/containers/{containerid}/issue-types
      name: issues-v1-containers-containerid-issue-types
      description: REST surface for issues-v1-containers-containerId-issue-types.
      operations:
      - method: GET
        name: getissuetypes
        description: Autodesk List Issue Types
        call: bim360-issues.getissuetypes
        with:
          containerId: rest.containerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/issues/v1/containers/{containerid}/quality-issues
      name: issues-v1-containers-containerid-quality-issues
      description: REST surface for issues-v1-containers-containerId-quality-issues.
      operations:
      - method: GET
        name: getissues
        description: Autodesk List Issues
        call: bim360-issues.getissues
        with:
          containerId: rest.containerId
          filter[status]: rest.filter[status]
          filter[assigned_to]: rest.filter[assigned_to]
          filter[due_date]: rest.filter[due_date]
          filter[created_at]: rest.filter[created_at]
          filter[target_urn]: rest.filter[target_urn]
          page[limit]: rest.page[limit]
          page[offset]: rest.page[offset]
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createissue
        description: Autodesk Create Issue
        call: bim360-issues.createissue
        with:
          containerId: rest.containerId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/issues/v1/containers/{containerid}/quality-issues/{issueid}
      name: issues-v1-containers-containerid-quality-issues-issueid
      description: REST surface for issues-v1-containers-containerId-quality-issues-issueId.
      operations:
      - method: GET
        name: getissue
        description: Autodesk Get Issue
        call: bim360-issues.getissue
        with:
          containerId: rest.containerId
          issueId: rest.issueId
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateissue
        description: Autodesk Update Issue
        call: bim360-issues.updateissue
        with:
          containerId: rest.containerId
          issueId: rest.issueId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/issues/v1/containers/{containerid}/quality-issues/{issueid}/comments
      name: issues-v1-containers-containerid-quality-issues-issueid-comments
      description: REST surface for issues-v1-containers-containerId-quality-issues-issueId-comments.
      operations:
      - method: GET
        name: getissuecomments
        description: Autodesk List Issue Comments
        call: bim360-issues.getissuecomments
        with:
          containerId: rest.containerId
          issueId: rest.issueId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createissuecomment
        description: Autodesk Create Issue Comment
        call: bim360-issues.createissuecomment
        with:
          containerId: rest.containerId
          issueId: rest.issueId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: bim360-issues-mcp
    port: 9090
    transport: http
    description: MCP adapter for Autodesk BIM 360 API — Issues. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: autodesk-list-issue-types
      description: Autodesk List Issue Types
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bim360-issues.getissuetypes
      with:
        containerId: tools.containerId
      outputParameters:
      - type: object
        mapping: $.
    - name: autodesk-list-issues
      description: Autodesk List Issues
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bim360-issues.getissues
      with:
        containerId: tools.containerId
        filter[status]: tools.filter[status]
        filter[assigned_to]: tools.filter[assigned_to]
        filter[due_date]: tools.filter[due_date]
        filter[created_at]: tools.filter[created_at]
        filter[target_urn]: tools.filter[target_urn]
        page[limit]: tools.page[limit]
        page[offset]: tools.page[offset]
      outputParameters:
      - type: object
        mapping: $.
    - name: autodesk-create-issue
      description: Autodesk Create Issue
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bim360-issues.createissue
      with:
        containerId: tools.containerId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: autodesk-get-issue
      description: Autodesk Get Issue
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bim360-issues.getissue
      with:
        containerId: tools.containerId
        issueId: tools.issueId
      outputParameters:
      - type: object
        mapping: $.
    - name: autodesk-update-issue
      description: Autodesk Update Issue
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: bim360-issues.updateissue
      with:
        containerId: tools.containerId
        issueId: tools.issueId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: autodesk-list-issue-comments
      description: Autodesk List Issue Comments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bim360-issues.getissuecomments
      with:
        containerId: tools.containerId
        issueId: tools.issueId
      outputParameters:
      - type: object
        mapping: $.
    - name: autodesk-create-issue-comment
      description: Autodesk Create Issue Comment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bim360-issues.createissuecomment
      with:
        containerId: tools.containerId
        issueId: tools.issueId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.