/
OP
openai
/
OpenAI API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 46m ago · Updated 14h ago
View markdown
openai
OpenAI API
delete
Delete a file and remove it from all vector stores.
63028c4d3916
latest
OpenAPI 3.1.0
MIT
raw.githubusercontent.com
2026-08-12
288
1,394
2.7 MB
Assistants
23
Audio
9
Audit Logs
1
Batch
4
Certificates
10
Chat
6
Completions
1
Conversations
8
Data retention
4
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
4
Group users
4
Groups
5
Hosted tools
2
Images
3
Invites
4
Models
3
Moderations
1
Project group role assignments
4
Project groups
4
Project user role assignments
4
Projects
23
Realtime
9
Responses
10
Roles
10
Skills
11
Spend alerts
10
Uploads
4
Usage
11
User organization role assignments
4
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
get
Get the organization's hard spend limit.
post
Create or replace the organization's hard spend limit.
delete
Delete the organization's hard spend limit.
get
Get a project's hard spend limit.
post
Create or replace a project's hard spend limit.
delete
Delete a project's hard spend limit.
post
Creates an API key for a service account in the project.
post
Check whether an image or audio file contains known OpenAI provenance signals. [Learn more about content provenance](/api/docs/guides/content-provenance). If `not_detected`, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.
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.
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
Returns input token counts of the request. Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
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
live_call_incoming
post
realtime_call_incoming
post
response_cancelled
post
response_completed
post
response_failed
post
response_incomplete
Files
Delete a file and remove it from all vector stores.
delete
/files/{file_id}
Path parameters
file_id
string
required
The ID of the file to use for this request.
Response
OK
DeleteFileResponse
required
id
string
required
object
'file'
required
deleted
boolean
required