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: $. - name: openai-when-run-has-status 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' hints: readOnly: false destructive: false idempotent: false call: threads-threads.submittoolouputstorun with: thread_id: tools.thread_id run_id: tools.run_id body: tools.body outputParameters: - type: object mapping: $.