naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure OpenAI Service API — Assistants
  description: 'Microsoft Azure Azure OpenAI Service API — Assistants. 27 operations. Lead operation: Microsoft Azure Returns
    A List Of Assistants. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Assistants
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-openai-service-assistants
    baseUri: https://{endpoint}/openai
    description: Microsoft Azure Azure OpenAI Service API — Assistants business capability. Self-contained, no shared references.
    resources:
    - name: assistants
      path: /assistants
      operations:
      - name: microsoftazurelistassistants
        method: GET
        description: Microsoft Azure Returns A List Of Assistants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 20.
        - name: order
          in: query
          type: string
          description: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending
            order.
        - name: after
          in: query
          type: string
          description: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance,
            if you make a list request and receive 100 objects, e
        - name: before
          in: query
          type: string
          description: 'A cursor for use in pagination. `before` is an object ID that defines your place in the list. For
            instance, if you make a list request and receive 100 objects, '
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazurecreateassistant
        method: POST
        description: Microsoft Azure Create An Assistant With A Model And Instructions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: assistants-assistant_id
      path: /assistants/{assistant_id}
      operations:
      - name: microsoftazuregetassistant
        method: GET
        description: Microsoft Azure Retrieves An Assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: assistant_id
          in: path
          type: string
          description: The ID of the assistant to retrieve.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazuredeleteassistant
        method: DELETE
        description: Microsoft Azure Delete An Assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: assistant_id
          in: path
          type: string
          description: The ID of the assistant to delete.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
    - name: assistants-assistant_id-files
      path: /assistants/{assistant_id}/files
      operations:
      - name: microsoftazurelistassistantfiles
        method: GET
        description: Microsoft Azure Returns A List Of Assistant Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: assistant_id
          in: path
          type: string
          description: The ID of the assistant the file belongs to.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 20.
        - name: order
          in: query
          type: string
          description: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending
            order.
        - name: after
          in: query
          type: string
          description: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance,
            if you make a list request and receive 100 objects, e
        - name: before
          in: query
          type: string
          description: 'A cursor for use in pagination. `before` is an object ID that defines your place in the list. For
            instance, if you make a list request and receive 100 objects, '
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazurecreateassistantfile
        method: POST
        description: Microsoft Azure Create An Assistant File By Attaching A [file] Docs Api Reference Files To An [assistant]
          Docs Api Reference Assistants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: assistant_id
          in: path
          type: string
          description: The ID of the assistant for which to create a File.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: assistants-assistant_id-files-file_id
      path: /assistants/{assistant_id}/files/{file_id}
      operations:
      - name: microsoftazuregetassistantfile
        method: GET
        description: Microsoft Azure Retrieves An Assistantfile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: assistant_id
          in: path
          type: string
          description: The ID of the assistant who the file belongs to.
          required: true
        - name: file_id
          in: path
          type: string
          description: The ID of the file we're getting.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazuredeleteassistantfile
        method: DELETE
        description: Microsoft Azure Delete An Assistant File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: assistant_id
          in: path
          type: string
          description: The ID of the assistant that the file belongs to.
          required: true
        - name: file_id
          in: path
          type: string
          description: The ID of the file to delete.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads
      path: /threads
      operations:
      - name: microsoftazurecreatethread
        method: POST
        description: Microsoft Azure Create A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-runs
      path: /threads/runs
      operations:
      - name: microsoftazurecreatethreadandrun
        method: POST
        description: Microsoft Azure Create A Thread And Run It In One Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-thread_id
      path: /threads/{thread_id}
      operations:
      - name: microsoftazuregetthread
        method: GET
        description: Microsoft Azure Retrieves A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to retrieve.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazuremodifythread
        method: POST
        description: Microsoft Azure Modifies A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to modify. Only the `metadata` can be modified.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: microsoftazuredeletethread
        method: DELETE
        description: Microsoft Azure Delete A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to delete.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads-thread_id-messages
      path: /threads/{thread_id}/messages
      operations:
      - name: microsoftazurelistmessages
        method: GET
        description: Microsoft Azure Returns A List Of Messages For A Given Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the [thread](/docs/api-reference/threads) the messages belong to.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 20.
        - name: order
          in: query
          type: string
          description: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending
            order.
        - name: after
          in: query
          type: string
          description: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance,
            if you make a list request and receive 100 objects, e
        - name: before
          in: query
          type: string
          description: 'A cursor for use in pagination. `before` is an object ID that defines your place in the list. For
            instance, if you make a list request and receive 100 objects, '
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazurecreatemessage
        method: POST
        description: Microsoft Azure Create A Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the [thread](/docs/api-reference/threads) to create a message for.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-thread_id-messages-message_id
      path: /threads/{thread_id}/messages/{message_id}
      operations:
      - name: microsoftazuregetmessage
        method: GET
        description: Microsoft Azure Retrieve A Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the [thread](/docs/api-reference/threads) to which this message belongs.
          required: true
        - name: message_id
          in: path
          type: string
          description: The ID of the message to retrieve.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazuremodifymessage
        method: POST
        description: Microsoft Azure Modifies A Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to which this message belongs.
          required: true
        - name: message_id
          in: path
          type: string
          description: The ID of the message to modify.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-thread_id-messages-message_id-files
      path: /threads/{thread_id}/messages/{message_id}/files
      operations:
      - name: microsoftazurelistmessagefiles
        method: GET
        description: Microsoft Azure Returns A List Of Message Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread that the message and files belong to.
          required: true
        - name: message_id
          in: path
          type: string
          description: The ID of the message that the files belongs to.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 20.
        - name: order
          in: query
          type: string
          description: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending
            order.
        - name: after
          in: query
          type: string
          description: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance,
            if you make a list request and receive 100 objects, e
        - name: before
          in: query
          type: string
          description: 'A cursor for use in pagination. `before` is an object ID that defines your place in the list. For
            instance, if you make a list request and receive 100 objects, '
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads-thread_id-messages-message_id-files-file_id
      path: /threads/{thread_id}/messages/{message_id}/files/{file_id}
      operations:
      - name: microsoftazuregetmessagefile
        method: GET
        description: Microsoft Azure Retrieves A Message File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to which the message and File belong.
          required: true
        - name: message_id
          in: path
          type: string
          description: The ID of the message the file belongs to.
          required: true
        - name: file_id
          in: path
          type: string
          description: The ID of the file being retrieved.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads-thread_id-runs
      path: /threads/{thread_id}/runs
      operations:
      - name: microsoftazurelistruns
        method: GET
        description: Microsoft Azure Returns A List Of Runs Belonging To A Thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread the run belongs to.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 20.
        - name: order
          in: query
          type: string
          description: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending
            order.
        - name: after
          in: query
          type: string
          description: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance,
            if you make a list request and receive 100 objects, e
        - name: before
          in: query
          type: string
          description: 'A cursor for use in pagination. `before` is an object ID that defines your place in the list. For
            instance, if you make a list request and receive 100 objects, '
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazurecreaterun
        method: POST
        description: Microsoft Azure Create A Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to run.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-thread_id-runs-run_id
      path: /threads/{thread_id}/runs/{run_id}
      operations:
      - name: microsoftazuregetrun
        method: GET
        description: Microsoft Azure Retrieves A Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the [thread](/docs/api-reference/threads) that was run.
          required: true
        - name: run_id
          in: path
          type: string
          description: The ID of the run to retrieve.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
      - name: microsoftazuremodifyrun
        method: POST
        description: Microsoft Azure Modifies A Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the [thread](/docs/api-reference/threads) that was run.
          required: true
        - name: run_id
          in: path
          type: string
          description: The ID of the run to modify.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-thread_id-runs-run_id-cancel
      path: /threads/{thread_id}/runs/{run_id}/cancel
      operations:
      - name: microsoftazurecancelrun
        method: POST
        description: Microsoft Azure Cancels A Run That Is `in Progress`
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to which this run belongs.
          required: true
        - name: run_id
          in: path
          type: string
          description: The ID of the run to cancel.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads-thread_id-runs-run_id-steps
      path: /threads/{thread_id}/runs/{run_id}/steps
      operations:
      - name: microsoftazurelistrunsteps
        method: GET
        description: Microsoft Azure Returns A List Of Run Steps Belonging To A Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread the run and run steps belong to.
          required: true
        - name: run_id
          in: path
          type: string
          description: The ID of the run the run steps belong to.
          required: true
        - name: limit
          in: query
          type: integer
          description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default
            is 20.
        - name: order
          in: query
          type: string
          description: Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending
            order.
        - name: after
          in: query
          type: string
          description: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance,
            if you make a list request and receive 100 objects, e
        - name: before
          in: query
          type: string
          description: 'A cursor for use in pagination. `before` is an object ID that defines your place in the list. For
            instance, if you make a list request and receive 100 objects, '
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads-thread_id-runs-run_id-steps-step_id
      path: /threads/{thread_id}/runs/{run_id}/steps/{step_id}
      operations:
      - name: microsoftazuregetrunstep
        method: GET
        description: Microsoft Azure Retrieves A Run Step
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the thread to which the run and run step belongs.
          required: true
        - name: run_id
          in: path
          type: string
          description: The ID of the run to which the run step belongs.
          required: true
        - name: step_id
          in: path
          type: string
          description: The ID of the run step to retrieve.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
    - name: threads-thread_id-runs-run_id-submit_tool_outputs
      path: /threads/{thread_id}/runs/{run_id}/submit_tool_outputs
      operations:
      - name: microsoftazuresubmittooloutputstorun
        method: POST
        description: 'Microsoft Azure When A Run Has The `status: "requires Action"` And `required Action Type` Is `submit
          Tool Outputs`, This Endpoint Can Be Used To Submit The Outputs From The Tool Calls Once They Re All Completed All
          Outputs Must Be Submitted'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: thread_id
          in: path
          type: string
          description: The ID of the [thread](/docs/api-reference/threads) to which this run belongs.
          required: true
        - name: run_id
          in: path
          type: string
          description: The ID of the run that requires the tool output submission.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.MICROSOFT_AZURE_API_KEY}}'
  exposes:
  - type: rest
    namespace: azure-openai-service-assistants-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure OpenAI Service API — Assistants. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/assistants
      name: assistants
      description: REST surface for assistants.
      operations:
      - method: GET
        name: microsoftazurelistassistants
        description: Microsoft Azure Returns A List Of Assistants
        call: azure-openai-service-assistants.microsoftazurelistassistants
        with:
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreateassistant
        description: Microsoft Azure Create An Assistant With A Model And Instructions
        call: azure-openai-service-assistants.microsoftazurecreateassistant
        with:
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/assistants/{assistant-id}
      name: assistants-assistant-id
      description: REST surface for assistants-assistant_id.
      operations:
      - method: GET
        name: microsoftazuregetassistant
        description: Microsoft Azure Retrieves An Assistant
        call: azure-openai-service-assistants.microsoftazuregetassistant
        with:
          assistant_id: rest.assistant_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeleteassistant
        description: Microsoft Azure Delete An Assistant
        call: azure-openai-service-assistants.microsoftazuredeleteassistant
        with:
          assistant_id: rest.assistant_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/assistants/{assistant-id}/files
      name: assistants-assistant-id-files
      description: REST surface for assistants-assistant_id-files.
      operations:
      - method: GET
        name: microsoftazurelistassistantfiles
        description: Microsoft Azure Returns A List Of Assistant Files
        call: azure-openai-service-assistants.microsoftazurelistassistantfiles
        with:
          assistant_id: rest.assistant_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreateassistantfile
        description: Microsoft Azure Create An Assistant File By Attaching A [file] Docs Api Reference Files To An [assistant]
          Docs Api Reference Assistants
        call: azure-openai-service-assistants.microsoftazurecreateassistantfile
        with:
          assistant_id: rest.assistant_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/assistants/{assistant-id}/files/{file-id}
      name: assistants-assistant-id-files-file-id
      description: REST surface for assistants-assistant_id-files-file_id.
      operations:
      - method: GET
        name: microsoftazuregetassistantfile
        description: Microsoft Azure Retrieves An Assistantfile
        call: azure-openai-service-assistants.microsoftazuregetassistantfile
        with:
          assistant_id: rest.assistant_id
          file_id: rest.file_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeleteassistantfile
        description: Microsoft Azure Delete An Assistant File
        call: azure-openai-service-assistants.microsoftazuredeleteassistantfile
        with:
          assistant_id: rest.assistant_id
          file_id: rest.file_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads
      name: threads
      description: REST surface for threads.
      operations:
      - method: POST
        name: microsoftazurecreatethread
        description: Microsoft Azure Create A Thread
        call: azure-openai-service-assistants.microsoftazurecreatethread
        with:
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/runs
      name: threads-runs
      description: REST surface for threads-runs.
      operations:
      - method: POST
        name: microsoftazurecreatethreadandrun
        description: Microsoft Azure Create A Thread And Run It In One Request
        call: azure-openai-service-assistants.microsoftazurecreatethreadandrun
        with:
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}
      name: threads-thread-id
      description: REST surface for threads-thread_id.
      operations:
      - method: GET
        name: microsoftazuregetthread
        description: Microsoft Azure Retrieves A Thread
        call: azure-openai-service-assistants.microsoftazuregetthread
        with:
          thread_id: rest.thread_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazuremodifythread
        description: Microsoft Azure Modifies A Thread
        call: azure-openai-service-assistants.microsoftazuremodifythread
        with:
          thread_id: rest.thread_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeletethread
        description: Microsoft Azure Delete A Thread
        call: azure-openai-service-assistants.microsoftazuredeletethread
        with:
          thread_id: rest.thread_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/messages
      name: threads-thread-id-messages
      description: REST surface for threads-thread_id-messages.
      operations:
      - method: GET
        name: microsoftazurelistmessages
        description: Microsoft Azure Returns A List Of Messages For A Given Thread
        call: azure-openai-service-assistants.microsoftazurelistmessages
        with:
          thread_id: rest.thread_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreatemessage
        description: Microsoft Azure Create A Message
        call: azure-openai-service-assistants.microsoftazurecreatemessage
        with:
          thread_id: rest.thread_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/messages/{message-id}
      name: threads-thread-id-messages-message-id
      description: REST surface for threads-thread_id-messages-message_id.
      operations:
      - method: GET
        name: microsoftazuregetmessage
        description: Microsoft Azure Retrieve A Message
        call: azure-openai-service-assistants.microsoftazuregetmessage
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazuremodifymessage
        description: Microsoft Azure Modifies A Message
        call: azure-openai-service-assistants.microsoftazuremodifymessage
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/messages/{message-id}/files
      name: threads-thread-id-messages-message-id-files
      description: REST surface for threads-thread_id-messages-message_id-files.
      operations:
      - method: GET
        name: microsoftazurelistmessagefiles
        description: Microsoft Azure Returns A List Of Message Files
        call: azure-openai-service-assistants.microsoftazurelistmessagefiles
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/messages/{message-id}/files/{file-id}
      name: threads-thread-id-messages-message-id-files-file-id
      description: REST surface for threads-thread_id-messages-message_id-files-file_id.
      operations:
      - method: GET
        name: microsoftazuregetmessagefile
        description: Microsoft Azure Retrieves A Message File
        call: azure-openai-service-assistants.microsoftazuregetmessagefile
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          file_id: rest.file_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/runs
      name: threads-thread-id-runs
      description: REST surface for threads-thread_id-runs.
      operations:
      - method: GET
        name: microsoftazurelistruns
        description: Microsoft Azure Returns A List Of Runs Belonging To A Thread
        call: azure-openai-service-assistants.microsoftazurelistruns
        with:
          thread_id: rest.thread_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreaterun
        description: Microsoft Azure Create A Run
        call: azure-openai-service-assistants.microsoftazurecreaterun
        with:
          thread_id: rest.thread_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/runs/{run-id}
      name: threads-thread-id-runs-run-id
      description: REST surface for threads-thread_id-runs-run_id.
      operations:
      - method: GET
        name: microsoftazuregetrun
        description: Microsoft Azure Retrieves A Run
        call: azure-openai-service-assistants.microsoftazuregetrun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazuremodifyrun
        description: Microsoft Azure Modifies A Run
        call: azure-openai-service-assistants.microsoftazuremodifyrun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/runs/{run-id}/cancel
      name: threads-thread-id-runs-run-id-cancel
      description: REST surface for threads-thread_id-runs-run_id-cancel.
      operations:
      - method: POST
        name: microsoftazurecancelrun
        description: Microsoft Azure Cancels A Run That Is `in Progress`
        call: azure-openai-service-assistants.microsoftazurecancelrun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/runs/{run-id}/steps
      name: threads-thread-id-runs-run-id-steps
      description: REST surface for threads-thread_id-runs-run_id-steps.
      operations:
      - method: GET
        name: microsoftazurelistrunsteps
        description: Microsoft Azure Returns A List Of Run Steps Belonging To A Run
        call: azure-openai-service-assistants.microsoftazurelistrunsteps
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/runs/{run-id}/steps/{step-id}
      name: threads-thread-id-runs-run-id-steps-step-id
      description: REST surface for threads-thread_id-runs-run_id-steps-step_id.
      operations:
      - method: GET
        name: microsoftazuregetrunstep
        description: Microsoft Azure Retrieves A Run Step
        call: azure-openai-service-assistants.microsoftazuregetrunstep
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          step_id: rest.step_id
          api-version: rest.api-version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/{thread-id}/runs/{run-id}/submit-tool-outputs
      name: threads-thread-id-runs-run-id-submit-tool-outputs
      description: REST surface for threads-thread_id-runs-run_id-submit_tool_outputs.
      operations:
      - method: POST
        name: microsoftazuresubmittooloutputstorun
        description: 'Microsoft Azure When A Run Has The `status: "requires Action"` And `required Action Type` Is `submit
          Tool Outputs`, This Endpoint Can Be Used To Submit The Outputs From The Tool Calls Once They Re All Completed All
          Outputs Must Be Submitted'
        call: azure-openai-service-assistants.microsoftazuresubmittooloutputstorun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-openai-service-assistants-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure OpenAI Service API — Assistants. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-returns-list-assistants
      description: Microsoft Azure Returns A List Of Assistants
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazurelistassistants
      with:
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-assistant-model
      description: Microsoft Azure Create An Assistant With A Model And Instructions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecreateassistant
      with:
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieves-assistant
      description: Microsoft Azure Retrieves An Assistant
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetassistant
      with:
        assistant_id: tools.assistant_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-assistant
      description: Microsoft Azure Delete An Assistant
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuredeleteassistant
      with:
        assistant_id: tools.assistant_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-list-assistant
      description: Microsoft Azure Returns A List Of Assistant Files
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazurelistassistantfiles
      with:
        assistant_id: tools.assistant_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-assistant-file
      description: Microsoft Azure Create An Assistant File By Attaching A [file] Docs Api Reference Files To An [assistant]
        Docs Api Reference Assistants
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecreateassistantfile
      with:
        assistant_id: tools.assistant_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieves-assistantfile
      description: Microsoft Azure Retrieves An Assistantfile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetassistantfile
      with:
        assistant_id: tools.assistant_id
        file_id: tools.file_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-assistant-file
      description: Microsoft Azure Delete An Assistant File
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuredeleteassistantfile
      with:
        assistant_id: tools.assistant_id
        file_id: tools.file_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-thread
      description: Microsoft Azure Create A Thread
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecreatethread
      with:
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-thread-and
      description: Microsoft Azure Create A Thread And Run It In One Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecreatethreadandrun
      with:
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieves-thread
      description: Microsoft Azure Retrieves A Thread
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetthread
      with:
        thread_id: tools.thread_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-modifies-thread
      description: Microsoft Azure Modifies A Thread
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazuremodifythread
      with:
        thread_id: tools.thread_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-thread
      description: Microsoft Azure Delete A Thread
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuredeletethread
      with:
        thread_id: tools.thread_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-list-messages
      description: Microsoft Azure Returns A List Of Messages For A Given Thread
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazurelistmessages
      with:
        thread_id: tools.thread_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-message
      description: Microsoft Azure Create A Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecreatemessage
      with:
        thread_id: tools.thread_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieve-message
      description: Microsoft Azure Retrieve A Message
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetmessage
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-modifies-message
      description: Microsoft Azure Modifies A Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazuremodifymessage
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-list-message
      description: Microsoft Azure Returns A List Of Message Files
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazurelistmessagefiles
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieves-message-file
      description: Microsoft Azure Retrieves A Message File
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetmessagefile
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        file_id: tools.file_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-list-runs
      description: Microsoft Azure Returns A List Of Runs Belonging To A Thread
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazurelistruns
      with:
        thread_id: tools.thread_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-run
      description: Microsoft Azure Create A Run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecreaterun
      with:
        thread_id: tools.thread_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieves-run
      description: Microsoft Azure Retrieves A Run
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetrun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-modifies-run
      description: Microsoft Azure Modifies A Run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazuremodifyrun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-cancels-run-that
      description: Microsoft Azure Cancels A Run That Is `in Progress`
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazurecancelrun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-list-run
      description: Microsoft Azure Returns A List Of Run Steps Belonging To A Run
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazurelistrunsteps
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-retrieves-run-step
      description: Microsoft Azure Retrieves A Run Step
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-openai-service-assistants.microsoftazuregetrunstep
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        step_id: tools.step_id
        api-version: tools.api-version
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-when-run-has
      description: 'Microsoft Azure When A Run Has The `status: "requires Action"` And `required Action Type` Is `submit Tool
        Outputs`, This Endpoint Can Be Used To Submit The Outputs From The Tool Calls Once They Re All Completed All Outputs
        Must Be Submitted'
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-assistants.microsoftazuresubmittooloutputstorun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.