OpenAI

OpenAI Threads API

The Threads API from OpenAI — 13 operation(s) for threads.

Documentation GitHub OpenAPI

Operations 19

GET /threads/{thread_id}/messages/{message_id}/files OpenAI Returns a list of message files #

GET /threads/{thread_id}/messages/{message_id}/files/{file_id} OpenAI Retrieves a message file #

POST /threads OpenAI Create a thread #

GET /threads/{thread_id} OpenAI Retrieves a thread #

POST /threads/{thread_id} OpenAI Modifies a thread #

DELETE /threads/{thread_id} OpenAI Delete a thread #

GET /threads/{thread_id}/messages OpenAI Returns a list of messages for a given thread #

POST /threads/{thread_id}/messages OpenAI Create a message #

GET /threads/{thread_id}/messages/{message_id} OpenAI Retrieve a message #

POST /threads/{thread_id}/messages/{message_id} OpenAI Modifies a message #

POST /threads/runs OpenAI Create a thread and run it in one request #

GET /threads/{thread_id}/runs OpenAI Returns a list of runs belonging to a thread #

POST /threads/{thread_id}/runs OpenAI Create a run #

GET /threads/{thread_id}/runs/{run_id} OpenAI Retrieves a run #

POST /threads/{thread_id}/runs/{run_id} OpenAI Modifies a run #

POST /threads/{thread_id}/runs/{run_id}/submit_tool_outputs OpenAI When a run has the `status: "requires_action"` and… #

POST /threads/{thread_id}/runs/{run_id}/cancel OpenAI Cancels a run that is `in_progress` #

GET /threads/{thread_id}/runs/{run_id}/steps OpenAI Returns a list of run steps belonging to a run #

GET /threads/{thread_id}/runs/{run_id}/steps/{step_id} OpenAI Retrieves a run step #

Documentation

https://platform.openai.com/docs/assistants/overview

https://platform.openai.com/docs/api-reference/assistants

https://platform.openai.com/docs/guides/text-to-speech

https://platform.openai.com/docs/api-reference/audio

https://platform.openai.com/docs/guides/speech-to-text

https://developers.openai.com/api/docs/guides/audio/

https://developers.openai.com/api/docs/guides/voice-agents/

https://platform.openai.com/docs/api-reference/chat

https://platform.openai.com/docs/guides/embeddings

https://platform.openai.com/docs/api-reference/embeddings

https://platform.openai.com/docs/api-reference/files

https://platform.openai.com/docs/guides/fine-tuning

https://platform.openai.com/docs/api-reference/fine-tuning

https://platform.openai.com/docs/guides/images

https://platform.openai.com/docs/api-reference/images

https://platform.openai.com/docs/guides/image-generation

https://platform.openai.com/docs/guides/images-vision

https://platform.openai.com/docs/models

https://platform.openai.com/docs/api-reference/models

https://platform.openai.com/docs/assistants/how-it-works/managing-threads-and-messages

https://platform.openai.com/docs/api-reference/threads

https://platform.openai.com/docs/api-reference/completions

Specifications

https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-threads-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-chat-completion-schema.json

https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-embedding-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-ld/openai-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/openai-threads-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Openai Threads API
  version: 2.0.0
  contact:
    name: OpenAI Support
    url: https://help.openai.com/
  license:
    name: MIT
    url: https://github.com/openai/openai-openapi/blob/master/LICENSE
  termsOfService: https://openai.com/policies/terms-of-use
  description: 'Operations tagged Threads across 2 of this provider''s published API definitions: files-openapi-original.yml, threads-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.openai.com/v1
security:
- ApiKeyAuth: []
tags:


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