OpenAI APIs · Capability

OpenAI APIs OpenAI Assistants API

API for building AI assistants with custom instructions, knowledge retrieval, code execution, and function calling capabilities. Supports managing assistants, threads, messages, and runs.

Run with Naftiko OpenaiApisAPI

What You Can Do

GET
Listassistants — OpenAI APIs List assistants
/assistants
POST
Createassistant — OpenAI APIs Create assistant
/assistants
GET
Getassistant — OpenAI APIs Retrieve assistant
/assistants/{assistant_id}
POST
Modifyassistant — OpenAI APIs Modify assistant
/assistants/{assistant_id}
DELETE
Deleteassistant — OpenAI APIs Delete assistant
/assistants/{assistant_id}
POST
Createthread — OpenAI APIs Create thread
/threads
GET
Getthread — OpenAI APIs Retrieve thread
/threads/{thread_id}
POST
Modifythread — OpenAI APIs Modify thread
/threads/{thread_id}
DELETE
Deletethread — OpenAI APIs Delete thread
/threads/{thread_id}
GET
Listmessages — OpenAI APIs List messages
/threads/{thread_id}/messages
POST
Createmessage — OpenAI APIs Create message
/threads/{thread_id}/messages
GET
Getmessage — OpenAI APIs Retrieve message
/threads/{thread_id}/messages/{message_id}
GET
Listruns — OpenAI APIs List runs
/threads/{thread_id}/runs
POST
Createrun — OpenAI APIs Create run
/threads/{thread_id}/runs
GET
Getrun — OpenAI APIs Retrieve run
/threads/{thread_id}/runs/{run_id}
POST
Cancelrun — OpenAI APIs Cancel run
/threads/{thread_id}/runs/{run_id}/cancel
POST
Submittooloutputs — OpenAI APIs Submit tool outputs
/threads/{thread_id}/runs/{run_id}/submit_tool_outputs
POST
Createthreadandrun — OpenAI APIs Create thread and run
/threads/runs

MCP Tools

listassistants

OpenAI APIs List assistants

read-only idempotent
createassistant

OpenAI APIs Create assistant

getassistant

OpenAI APIs Retrieve assistant

read-only idempotent
modifyassistant

OpenAI APIs Modify assistant

deleteassistant

OpenAI APIs Delete assistant

idempotent
createthread

OpenAI APIs Create thread

getthread

OpenAI APIs Retrieve thread

read-only idempotent
modifythread

OpenAI APIs Modify thread

deletethread

OpenAI APIs Delete thread

idempotent
listmessages

OpenAI APIs List messages

read-only idempotent
createmessage

OpenAI APIs Create message

getmessage

OpenAI APIs Retrieve message

read-only idempotent
listruns

OpenAI APIs List runs

read-only idempotent
createrun

OpenAI APIs Create run

getrun

OpenAI APIs Retrieve run

read-only idempotent
cancelrun

OpenAI APIs Cancel run

submittooloutputs

OpenAI APIs Submit tool outputs

createthreadandrun

OpenAI APIs Create thread and run

Capability Spec

openai-apis-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: OpenAI APIs OpenAI Assistants API
  description: API for building AI assistants with custom instructions, knowledge retrieval, code execution, and function
    calling capabilities. Supports managing assistants, threads, messages, and runs.
  tags:
  - Openai
  - Apis
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: openai-apis
    baseUri: https://api.openai.com/v1
    description: OpenAI APIs OpenAI Assistants API HTTP API.
    authentication:
      type: bearer
      token: '{{OPENAI_APIS_TOKEN}}'
    resources:
    - name: assistants
      path: /assistants
      operations:
      - name: listassistants
        method: GET
        description: OpenAI APIs List assistants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createassistant
        method: POST
        description: OpenAI APIs Create assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: assistants-assistant-id
      path: /assistants/{assistant_id}
      operations:
      - name: getassistant
        method: GET
        description: OpenAI APIs Retrieve assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: modifyassistant
        method: POST
        description: OpenAI APIs Modify assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteassistant
        method: DELETE
        description: OpenAI APIs Delete assistant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads
      path: /threads
      operations:
      - name: createthread
        method: POST
        description: OpenAI APIs Create thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id
      path: /threads/{thread_id}
      operations:
      - name: getthread
        method: GET
        description: OpenAI APIs Retrieve thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: modifythread
        method: POST
        description: OpenAI APIs Modify thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletethread
        method: DELETE
        description: OpenAI APIs Delete thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id-messages
      path: /threads/{thread_id}/messages
      operations:
      - name: listmessages
        method: GET
        description: OpenAI APIs List messages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createmessage
        method: POST
        description: OpenAI APIs Create message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id-messages-message-id
      path: /threads/{thread_id}/messages/{message_id}
      operations:
      - name: getmessage
        method: GET
        description: OpenAI APIs Retrieve message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id-runs
      path: /threads/{thread_id}/runs
      operations:
      - name: listruns
        method: GET
        description: OpenAI APIs List runs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createrun
        method: POST
        description: OpenAI APIs Create run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id-runs-run-id
      path: /threads/{thread_id}/runs/{run_id}
      operations:
      - name: getrun
        method: GET
        description: OpenAI APIs Retrieve run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id-runs-run-id-cancel
      path: /threads/{thread_id}/runs/{run_id}/cancel
      operations:
      - name: cancelrun
        method: POST
        description: OpenAI APIs Cancel run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-thread-id-runs-run-id-submit-tool-output
      path: /threads/{thread_id}/runs/{run_id}/submit_tool_outputs
      operations:
      - name: submittooloutputs
        method: POST
        description: OpenAI APIs Submit tool outputs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: threads-runs
      path: /threads/runs
      operations:
      - name: createthreadandrun
        method: POST
        description: OpenAI APIs Create thread and run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: openai-apis-rest
    description: REST adapter for OpenAI APIs OpenAI Assistants API.
    resources:
    - path: /assistants
      name: listassistants
      operations:
      - method: GET
        name: listassistants
        description: OpenAI APIs List assistants
        call: openai-apis.listassistants
        outputParameters:
        - type: object
          mapping: $.
    - path: /assistants
      name: createassistant
      operations:
      - method: POST
        name: createassistant
        description: OpenAI APIs Create assistant
        call: openai-apis.createassistant
        outputParameters:
        - type: object
          mapping: $.
    - path: /assistants/{assistant_id}
      name: getassistant
      operations:
      - method: GET
        name: getassistant
        description: OpenAI APIs Retrieve assistant
        call: openai-apis.getassistant
        outputParameters:
        - type: object
          mapping: $.
    - path: /assistants/{assistant_id}
      name: modifyassistant
      operations:
      - method: POST
        name: modifyassistant
        description: OpenAI APIs Modify assistant
        call: openai-apis.modifyassistant
        outputParameters:
        - type: object
          mapping: $.
    - path: /assistants/{assistant_id}
      name: deleteassistant
      operations:
      - method: DELETE
        name: deleteassistant
        description: OpenAI APIs Delete assistant
        call: openai-apis.deleteassistant
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads
      name: createthread
      operations:
      - method: POST
        name: createthread
        description: OpenAI APIs Create thread
        call: openai-apis.createthread
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}
      name: getthread
      operations:
      - method: GET
        name: getthread
        description: OpenAI APIs Retrieve thread
        call: openai-apis.getthread
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}
      name: modifythread
      operations:
      - method: POST
        name: modifythread
        description: OpenAI APIs Modify thread
        call: openai-apis.modifythread
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}
      name: deletethread
      operations:
      - method: DELETE
        name: deletethread
        description: OpenAI APIs Delete thread
        call: openai-apis.deletethread
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/messages
      name: listmessages
      operations:
      - method: GET
        name: listmessages
        description: OpenAI APIs List messages
        call: openai-apis.listmessages
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/messages
      name: createmessage
      operations:
      - method: POST
        name: createmessage
        description: OpenAI APIs Create message
        call: openai-apis.createmessage
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/messages/{message_id}
      name: getmessage
      operations:
      - method: GET
        name: getmessage
        description: OpenAI APIs Retrieve message
        call: openai-apis.getmessage
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/runs
      name: listruns
      operations:
      - method: GET
        name: listruns
        description: OpenAI APIs List runs
        call: openai-apis.listruns
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/runs
      name: createrun
      operations:
      - method: POST
        name: createrun
        description: OpenAI APIs Create run
        call: openai-apis.createrun
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/runs/{run_id}
      name: getrun
      operations:
      - method: GET
        name: getrun
        description: OpenAI APIs Retrieve run
        call: openai-apis.getrun
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/runs/{run_id}/cancel
      name: cancelrun
      operations:
      - method: POST
        name: cancelrun
        description: OpenAI APIs Cancel run
        call: openai-apis.cancelrun
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/{thread_id}/runs/{run_id}/submit_tool_outputs
      name: submittooloutputs
      operations:
      - method: POST
        name: submittooloutputs
        description: OpenAI APIs Submit tool outputs
        call: openai-apis.submittooloutputs
        outputParameters:
        - type: object
          mapping: $.
    - path: /threads/runs
      name: createthreadandrun
      operations:
      - method: POST
        name: createthreadandrun
        description: OpenAI APIs Create thread and run
        call: openai-apis.createthreadandrun
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: openai-apis-mcp
    transport: http
    description: MCP adapter for OpenAI APIs OpenAI Assistants API for AI agent use.
    tools:
    - name: listassistants
      description: OpenAI APIs List assistants
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.listassistants
      outputParameters:
      - type: object
        mapping: $.
    - name: createassistant
      description: OpenAI APIs Create assistant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.createassistant
      outputParameters:
      - type: object
        mapping: $.
    - name: getassistant
      description: OpenAI APIs Retrieve assistant
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.getassistant
      outputParameters:
      - type: object
        mapping: $.
    - name: modifyassistant
      description: OpenAI APIs Modify assistant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.modifyassistant
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteassistant
      description: OpenAI APIs Delete assistant
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: openai-apis.deleteassistant
      outputParameters:
      - type: object
        mapping: $.
    - name: createthread
      description: OpenAI APIs Create thread
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.createthread
      outputParameters:
      - type: object
        mapping: $.
    - name: getthread
      description: OpenAI APIs Retrieve thread
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.getthread
      outputParameters:
      - type: object
        mapping: $.
    - name: modifythread
      description: OpenAI APIs Modify thread
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.modifythread
      outputParameters:
      - type: object
        mapping: $.
    - name: deletethread
      description: OpenAI APIs Delete thread
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: openai-apis.deletethread
      outputParameters:
      - type: object
        mapping: $.
    - name: listmessages
      description: OpenAI APIs List messages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.listmessages
      outputParameters:
      - type: object
        mapping: $.
    - name: createmessage
      description: OpenAI APIs Create message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.createmessage
      outputParameters:
      - type: object
        mapping: $.
    - name: getmessage
      description: OpenAI APIs Retrieve message
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.getmessage
      outputParameters:
      - type: object
        mapping: $.
    - name: listruns
      description: OpenAI APIs List runs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.listruns
      outputParameters:
      - type: object
        mapping: $.
    - name: createrun
      description: OpenAI APIs Create run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.createrun
      outputParameters:
      - type: object
        mapping: $.
    - name: getrun
      description: OpenAI APIs Retrieve run
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: openai-apis.getrun
      outputParameters:
      - type: object
        mapping: $.
    - name: cancelrun
      description: OpenAI APIs Cancel run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.cancelrun
      outputParameters:
      - type: object
        mapping: $.
    - name: submittooloutputs
      description: OpenAI APIs Submit tool outputs
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.submittooloutputs
      outputParameters:
      - type: object
        mapping: $.
    - name: createthreadandrun
      description: OpenAI APIs Create thread and run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: openai-apis.createthreadandrun
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    OPENAI_APIS_TOKEN: OPENAI_APIS_TOKEN