/
/OpenAI API
ChangesDocsSign in
Sign in
  • APIs
  • Generators
  • Stacks
  • Projects
  • Docs
  • History
  • Schema
Checked 29m ago · Updated 3h ago
Assistants23
Audio9
Audit Logs1
Batch4
Certificates10
Chat6
Completions1
Conversations8
Data retention4
Embeddings1
Evals12
Files5
Fine-tuning13
Group organization role assignments4
Group users4
Groups5
Hosted tools2
Images3
Invites4
Models3
Moderations1
Project group role assignments4
Project groups4
Project user role assignments4
Projects23
Realtime9
  • postCreate a new Realtime API call over WebRTC and receive the SDP answer needed to complete the peer connection.
  • postAccept an incoming SIP call and configure the realtime session that will handle it.
  • postEnd an active Realtime API call, whether it was initiated over SIP or WebRTC.
  • postTransfer an active SIP call to a new destination using the SIP REFER verb.
  • postDecline an incoming SIP call by returning a SIP status code to the caller.
  • postCreate a Realtime client secret with an associated session configuration. Client secrets are short-lived tokens that can be passed to a client app, such as a web frontend or mobile client, which grants access to the Realtime API without leaking your main API key. You can configure a custom TTL for each client secret. You can also attach session configuration options to the client secret, which will be applied to any sessions created using that client secret, but these can also be overridden by the client connection. [Learn more about authentication with client secrets over WebRTC](/docs/guides/realtime-webrtc). Returns the created client secret and the effective session object. The client secret is a string that looks like `ek_1234`.
  • postCreate an ephemeral API token for use in client-side applications with the Realtime API. Can be configured with the same session parameters as the `session.update` client event. It responds with a session object, plus a `client_secret` key which contains a usable ephemeral API token that can be used to authenticate browser clients for the Realtime API. Returns the created Realtime session object, plus an ephemeral key.
  • postCreate an ephemeral API token for use in client-side applications with the Realtime API specifically for realtime transcriptions. Can be configured with the same session parameters as the `transcription_session.update` client event. It responds with a session object, plus a `client_secret` key which contains a usable ephemeral API token that can be used to authenticate browser clients for the Realtime API. Returns the created Realtime transcription session object, plus an ephemeral key.
  • postCreate a Realtime translation client secret with an associated translation session configuration. Client secrets are short-lived tokens that can be passed to a client app, such as a web frontend or mobile client, which grants access to the Realtime Translation API without leaking your main API key. You can configure a custom TTL for each client secret. Returns the created client secret and the effective translation session object. The client secret is a string that looks like `ek_1234`.
Responses10
Roles10
Skills11
Spend alerts10
Uploads4
Usage11
User organization role assignments4
Users4
Vector stores16
Videos10
  • getList Containers
  • postCreate Container
  • getRetrieve Container
  • deleteDelete Container
  • getList Container files
  • postCreate 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.
  • getRetrieve Container File
  • deleteDelete Container File
  • getRetrieve Container File Content
  • getList organization API keys
  • postCreate an organization admin API key
  • getRetrieve a single organization API key
  • deleteDelete an organization admin API key
  • getGet the organization's hard spend limit.
  • postCreate or replace the organization's hard spend limit.
  • deleteDelete the organization's hard spend limit.
  • getGet a project's hard spend limit.
  • postCreate or replace a project's hard spend limit.
  • deleteDelete a project's hard spend limit.
  • postCreates an API key for a service account in the project.
  • postCheck 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.
  • postReturns input token counts of the request. Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
  • postCompact 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).
  • postCancel an active ChatKit session and return its most recent metadata. Cancelling prevents new requests from using the issued client secret.
  • postCreate a ChatKit session.
  • getList items that belong to a ChatKit thread.
  • getRetrieve a ChatKit thread by its identifier.
  • deleteDelete a ChatKit thread along with its items and stored attachments.
  • getList ChatKit threads with optional pagination and user filters.
  • postCompact 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).
  • postReturns input token counts of the request. Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
Webhooks
  • postbatch_cancelled
  • postbatch_completed
  • postbatch_expired
  • postbatch_failed
  • posteval_run_canceled
  • posteval_run_failed
  • posteval_run_succeeded
  • postfine_tuning_job_cancelled
  • postfine_tuning_job_failed
  • postfine_tuning_job_succeeded
  • postlive_call_incoming
  • postrealtime_call_incoming
  • postresponse_cancelled
  • postresponse_completed
  • postresponse_failed
  • postresponse_incomplete
  • postsafety_alert_created
  • postsafety_org_alert_created