/
OP
openai
/
OpenAI API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 8m ago · Updated 4w ago
View markdown
openai
OpenAI API
get
Returns the contents of the specified file.
v1
latest
OpenAPI 3.1.0
MIT
2026-07-13
242
959
2.7 MB
Assistants
23
Audio
9
Audit Logs
1
Batch
4
Certificates
10
Chat
6
Completions
1
Conversations
8
Embeddings
1
Evals
12
Files
5
get
Returns a list of files.
post
Upload a file that can be used across various endpoints. Individual files can be up to 512 MB, and each project can store up to 2.5 TB of files in total. There is no organization-wide storage limit. Uploads to this endpoint are rate-limited to 1,000 requests per minute per authenticated user. - The Assistants API supports files up to 2 million tokens and of specific file types. See the [Assistants Tools guide](/docs/assistants/tools) for details. - The Fine-tuning API only supports `.jsonl` files. The input also has certain required formats for fine-tuning [chat](/docs/api-reference/fine-tuning/chat-input) or [completions](/docs/api-reference/fine-tuning/completions-input) models. - The Batch API only supports `.jsonl` files up to 200 MB in size. The input also has a specific required [format](/docs/api-reference/batch/request-input). - For Retrieval or `file_search` ingestion, upload files here first. If you need to attach multiple uploaded files to the same vector store, use [`/vector_stores/{vector_store_id}/file_batches`](/docs/api-reference/vector-stores-file-batches/createBatch) instead of attaching them one by one. Vector store attachment has separate limits from file upload, including 2,000 attached files per minute per organization. Please [contact us](https://help.openai.com/) if you need to increase these storage limits.
get
Returns information about a specific file.
delete
Delete a file and remove it from all vector stores.
get
Returns the contents of the specified file.
Fine-tuning
13
Group organization role assignments
3
Group users
3
Groups
4
Images
3
Invites
4
Models
3
Moderations
1
Project group role assignments
3
Project groups
3
Project user role assignments
3
Projects
19
Realtime
9
Responses
5
Roles
8
Skills
11
Uploads
4
Usage
9
User organization role assignments
3
Users
4
Vector stores
16
Videos
10
get
List Containers
post
Create Container
get
Retrieve Container
delete
Delete Container
get
List Container files
post
Create a Container File You can send either a multipart/form-data request with the raw file content, or a JSON request with a file ID.
get
Retrieve Container File
delete
Delete Container File
get
Retrieve Container File Content
get
List organization API keys
post
Create an organization admin API key
get
Retrieve a single organization API key
delete
Delete an organization admin API key
post
Returns input token counts of the request. Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
post
Compact a conversation. Returns a compacted response object. Learn when and how to compact long-running conversations in the [conversation state guide](/docs/guides/conversation-state#managing-the-context-window). For ZDR-compatible compaction details, see [Compaction (advanced)](/docs/guides/conversation-state#compaction-advanced).
post
Cancel an active ChatKit session and return its most recent metadata. Cancelling prevents new requests from using the issued client secret.
post
Create a ChatKit session.
get
List items that belong to a ChatKit thread.
get
Retrieve a ChatKit thread by its identifier.
delete
Delete a ChatKit thread along with its items and stored attachments.
get
List ChatKit threads with optional pagination and user filters.
Webhooks
post
batch_cancelled
post
batch_completed
post
batch_expired
post
batch_failed
post
eval_run_canceled
post
eval_run_failed
post
eval_run_succeeded
post
fine_tuning_job_cancelled
post
fine_tuning_job_failed
post
fine_tuning_job_succeeded
post
realtime_call_incoming
post
response_cancelled
post
response_completed
post
response_failed
post
response_incomplete
Files
Returns the contents of the specified file.
get
/files/{file_id}/content
Path parameters
file_id
string
required
The ID of the file to use for this request.
Response
OK
string
required