OpenAI · Capability

OpenAI threads — Threads

OpenAI threads — Threads. 19 operations. Lead operation: OpenAI Create a thread.. Self-contained Naftiko capability covering one Openai business surface.

Run with Naftiko OpenaiThreads

What You Can Do

POST
Createthread — OpenAI Create a thread.
/v1/threads
POST
Createthreadandrun — OpenAI Create a thread and run it in one request.
/v1/threads/runs
GET
Getthread — OpenAI Retrieves a thread.
/v1/threads/{thread-id}
POST
Modifythread — OpenAI Modifies a thread.
/v1/threads/{thread-id}
DELETE
Deletethread — OpenAI Delete a thread.
/v1/threads/{thread-id}
GET
Listmessages — OpenAI Returns a list of messages for a given thread.
/v1/threads/{thread-id}/messages
POST
Createmessage — OpenAI Create a message.
/v1/threads/{thread-id}/messages
GET
Getmessage — OpenAI Retrieve a message.
/v1/threads/{thread-id}/messages/{message-id}
POST
Modifymessage — OpenAI Modifies a message.
/v1/threads/{thread-id}/messages/{message-id}
GET
Listmessagefiles — OpenAI Returns a list of message files.
/v1/threads/{thread-id}/messages/{message-id}/files
GET
Getmessagefile — OpenAI Retrieves a message file.
/v1/threads/{thread-id}/messages/{message-id}/files/{file-id}
GET
Listruns — OpenAI Returns a list of runs belonging to a thread.
/v1/threads/{thread-id}/runs
POST
Createrun — OpenAI Create a run.
/v1/threads/{thread-id}/runs
GET
Getrun — OpenAI Retrieves a run.
/v1/threads/{thread-id}/runs/{run-id}
POST
Modifyrun — OpenAI Modifies a run.
/v1/threads/{thread-id}/runs/{run-id}
POST
Cancelrun — OpenAI Cancels a run that is `in_progress`.
/v1/threads/{thread-id}/runs/{run-id}/cancel
GET
Listrunsteps — OpenAI Returns a list of run steps belonging to a run.
/v1/threads/{thread-id}/runs/{run-id}/steps
GET
Getrunstep — OpenAI Retrieves a run step.
/v1/threads/{thread-id}/runs/{run-id}/steps/{step-id}
POST
Submittoolouputstorun — OpenAI 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 in a si
/v1/threads/{thread-id}/runs/{run-id}/submit-tool-outputs

MCP Tools

openai-create-thread

OpenAI Create a thread.

openai-create-thread-and-run

OpenAI Create a thread and run it in one request.

openai-retrieves-thread

OpenAI Retrieves a thread.

read-only idempotent
openai-modifies-thread

OpenAI Modifies a thread.

openai-delete-thread

OpenAI Delete a thread.

idempotent
openai-returns-list-messages-given

OpenAI Returns a list of messages for a given thread.

read-only idempotent
openai-create-message

OpenAI Create a message.

openai-retrieve-message

OpenAI Retrieve a message.

read-only idempotent
openai-modifies-message

OpenAI Modifies a message.

openai-returns-list-message-files

OpenAI Returns a list of message files.

read-only idempotent
openai-retrieves-message-file

OpenAI Retrieves a message file.

read-only idempotent
openai-returns-list-runs-belonging

OpenAI Returns a list of runs belonging to a thread.

read-only idempotent
openai-create-run

OpenAI Create a run.

openai-retrieves-run

OpenAI Retrieves a run.

read-only idempotent
openai-modifies-run

OpenAI Modifies a run.

openai-cancels-run-that-is

OpenAI Cancels a run that is `in_progress`.

openai-returns-list-run-steps

OpenAI Returns a list of run steps belonging to a run.

read-only idempotent
openai-retrieves-run-step

OpenAI Retrieves a run step.

read-only idempotent
openai-when-run-has-status

OpenAI 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 in a si

Capability Spec

threads-threads.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: OpenAI threads — Threads
  description: 'OpenAI threads — Threads. 19 operations. Lead operation: OpenAI Create a thread.. Self-contained Naftiko capability
    covering one Openai business surface.'
  tags:
  - Openai
  - Threads
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    OPENAI_API_KEY: OPENAI_API_KEY
capability:
  consumes:
  - type: http
    namespace: threads-threads
    baseUri: https://api.openai.com/v1
    description: OpenAI threads — Threads business capability. Self-contained, no shared references.
    resources:
    - name: threads
      path: /threads
      operations:
      - name: createthread
        method: POST
        description: OpenAI Create a thread.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: threads-runs
      path: /threads/runs
      operations:
      - name: createthreadandrun
        method: POST
        description: OpenAI Create a thread and run it in one request.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: threads-thread_id
      path: /threads/{thread_id}
      operations:
      - name: getthread
        method: GET
        description: OpenAI 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: modifythread
        method: POST
        description: OpenAI 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: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deletethread
        method: DELETE
        description: OpenAI 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: threads-thread_id-messages
      path: /threads/{thread_id}/messages
      operations:
      - name: listmessages
        method: GET
        description: OpenAI 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: createmessage
        method: POST
        description: OpenAI 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: 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: getmessage
        method: GET
        description: OpenAI 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: modifymessage
        method: POST
        description: OpenAI 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: 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: listmessagefiles
        method: GET
        description: OpenAI 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: threads-thread_id-messages-message_id-files-file_id
      path: /threads/{thread_id}/messages/{message_id}/files/{file_id}
      operations:
      - name: getmessagefile
        method: GET
        description: OpenAI 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: threads-thread_id-runs
      path: /threads/{thread_id}/runs
      operations:
      - name: listruns
        method: GET
        description: OpenAI 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: createrun
        method: POST
        description: OpenAI 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: 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: getrun
        method: GET
        description: OpenAI 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: modifyrun
        method: POST
        description: OpenAI 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: 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: cancelrun
        method: POST
        description: OpenAI 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: threads-thread_id-runs-run_id-steps
      path: /threads/{thread_id}/runs/{run_id}/steps
      operations:
      - name: listrunsteps
        method: GET
        description: OpenAI 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: threads-thread_id-runs-run_id-steps-step_id
      path: /threads/{thread_id}/runs/{run_id}/steps/{step_id}
      operations:
      - name: getrunstep
        method: GET
        description: OpenAI 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: threads-thread_id-runs-run_id-submit_tool_outputs
      path: /threads/{thread_id}/runs/{run_id}/submit_tool_outputs
      operations:
      - name: submittoolouputstorun
        method: POST
        description: 'OpenAI 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 in a si'
        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: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.OPENAI_API_KEY}}'
  exposes:
  - type: rest
    namespace: threads-threads-rest
    port: 8080
    description: REST adapter for OpenAI threads — Threads. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/threads
      name: threads
      description: REST surface for threads.
      operations:
      - method: POST
        name: createthread
        description: OpenAI Create a thread.
        call: threads-threads.createthread
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/threads/runs
      name: threads-runs
      description: REST surface for threads-runs.
      operations:
      - method: POST
        name: createthreadandrun
        description: OpenAI Create a thread and run it in one request.
        call: threads-threads.createthreadandrun
        with:
          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: getthread
        description: OpenAI Retrieves a thread.
        call: threads-threads.getthread
        with:
          thread_id: rest.thread_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: modifythread
        description: OpenAI Modifies a thread.
        call: threads-threads.modifythread
        with:
          thread_id: rest.thread_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletethread
        description: OpenAI Delete a thread.
        call: threads-threads.deletethread
        with:
          thread_id: rest.thread_id
        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: listmessages
        description: OpenAI Returns a list of messages for a given thread.
        call: threads-threads.listmessages
        with:
          thread_id: rest.thread_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createmessage
        description: OpenAI Create a message.
        call: threads-threads.createmessage
        with:
          thread_id: rest.thread_id
          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: getmessage
        description: OpenAI Retrieve a message.
        call: threads-threads.getmessage
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: modifymessage
        description: OpenAI Modifies a message.
        call: threads-threads.modifymessage
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          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: listmessagefiles
        description: OpenAI Returns a list of message files.
        call: threads-threads.listmessagefiles
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
        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: getmessagefile
        description: OpenAI Retrieves a message file.
        call: threads-threads.getmessagefile
        with:
          thread_id: rest.thread_id
          message_id: rest.message_id
          file_id: rest.file_id
        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: listruns
        description: OpenAI Returns a list of runs belonging to a thread.
        call: threads-threads.listruns
        with:
          thread_id: rest.thread_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createrun
        description: OpenAI Create a run.
        call: threads-threads.createrun
        with:
          thread_id: rest.thread_id
          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: getrun
        description: OpenAI Retrieves a run.
        call: threads-threads.getrun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: modifyrun
        description: OpenAI Modifies a run.
        call: threads-threads.modifyrun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          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: cancelrun
        description: OpenAI Cancels a run that is `in_progress`.
        call: threads-threads.cancelrun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
        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: listrunsteps
        description: OpenAI Returns a list of run steps belonging to a run.
        call: threads-threads.listrunsteps
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          limit: rest.limit
          order: rest.order
          after: rest.after
          before: rest.before
        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: getrunstep
        description: OpenAI Retrieves a run step.
        call: threads-threads.getrunstep
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          step_id: rest.step_id
        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: submittoolouputstorun
        description: 'OpenAI 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 in a si'
        call: threads-threads.submittoolouputstorun
        with:
          thread_id: rest.thread_id
          run_id: rest.run_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: threads-threads-mcp
    port: 9090
    transport: http
    description: MCP adapter for OpenAI threads — Threads. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: openai-create-thread
      description: OpenAI Create a thread.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.createthread
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-create-thread-and-run
      description: OpenAI Create a thread and run it in one request.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.createthreadandrun
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-retrieves-thread
      description: OpenAI Retrieves a thread.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.getthread
      with:
        thread_id: tools.thread_id
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-modifies-thread
      description: OpenAI Modifies a thread.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.modifythread
      with:
        thread_id: tools.thread_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-delete-thread
      description: OpenAI Delete a thread.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: threads-threads.deletethread
      with:
        thread_id: tools.thread_id
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-returns-list-messages-given
      description: OpenAI Returns a list of messages for a given thread.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.listmessages
      with:
        thread_id: tools.thread_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-create-message
      description: OpenAI Create a message.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.createmessage
      with:
        thread_id: tools.thread_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-retrieve-message
      description: OpenAI Retrieve a message.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.getmessage
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-modifies-message
      description: OpenAI Modifies a message.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.modifymessage
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-returns-list-message-files
      description: OpenAI Returns a list of message files.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.listmessagefiles
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-retrieves-message-file
      description: OpenAI Retrieves a message file.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.getmessagefile
      with:
        thread_id: tools.thread_id
        message_id: tools.message_id
        file_id: tools.file_id
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-returns-list-runs-belonging
      description: OpenAI Returns a list of runs belonging to a thread.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.listruns
      with:
        thread_id: tools.thread_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-create-run
      description: OpenAI Create a run.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.createrun
      with:
        thread_id: tools.thread_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-retrieves-run
      description: OpenAI Retrieves a run.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.getrun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-modifies-run
      description: OpenAI Modifies a run.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.modifyrun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-cancels-run-that-is
      description: OpenAI Cancels a run that is `in_progress`.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: threads-threads.cancelrun
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-returns-list-run-steps
      description: OpenAI Returns a list of run steps belonging to a run.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.listrunsteps
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        limit: tools.limit
        order: tools.order
        after: tools.after
        before: tools.before
      outputParameters:
      - type: object
        mapping: $.
    - name: openai-retrieves-run-step
      description: OpenAI Retrieves a run step.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: threads-threads.getrunstep
      with:
        thread_id: tools.thread_id
        run_id: tools.run_id
        step_id: tools.step_id
      outputParameters:
      - type: object
        mapping: $.
    - 

# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/capabilities/threads-threads.yaml