Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: OpenAI Organization API
description: The OpenAI REST API. Please see https://platform.openai.com/docs/api-reference for more details.
version: 2.3.0
termsOfService: https://openai.com/policies/terms-of-use
contact:
name: OpenAI Support
url: https://help.openai.com/
license:
name: MIT
url: https://github.com/openai/openai-openapi/blob/master/LICENSE
servers:
- url: https://api.openai.com/v1
security:
- ApiKeyAuth: []
tags:
- name: Organization
paths:
/organization/admin_api_keys:
get:
security:
- AdminApiKeyAuth: []
summary: List organization API keys
operationId: admin-api-keys-list
description: Retrieve a paginated list of organization admin API keys.
parameters:
- in: query
name: after
required: false
schema:
type: string
nullable: true
description: Return keys with IDs that come after this ID in the pagination order.
- in: query
name: order
required: false
schema:
type: string
enum:
- asc
- desc
default: asc
description: Order results by creation time, ascending or descending.
- in: query
name: limit
required: false
schema:
type: integer
default: 20
description: Maximum number of keys to return.
responses:
'200':
description: A list of organization API keys.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiKeyList'
x-oaiMeta:
name: List all organization and project API keys.
group: administration
examples:
request:
curl: "curl https://api.openai.com/v1/organization/admin_api_keys?after=key_abc&limit=20 \\\n -H \"Authorization: Bearer $OPENAI_ADMIN_KEY\" \\\n -H \"Content-Type: application/json\"\n"
node.js: "import OpenAI from 'openai';\n\nconst client = new OpenAI({\n adminAPIKey: process.env['OPENAI_ADMIN_KEY'], // This is the default and can be omitted\n});\n\n// Automatically fetches more pages as needed.\nfor await (const adminAPIKey of client.admin.organization.adminAPIKeys.list()) {\n console.log(adminAPIKey.id);\n}"
python: "import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n admin_api_key=os.environ.get(\"OPENAI_ADMIN_KEY\"), # This is the default and can be omitted\n)\npage = client.admin.organization.admin_api_keys.list()\npage = page.data[0]\nprint(page.id)"
go: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/openai/openai-go\"\n\t\"github.com/openai/openai-go/option\"\n)\n\nfunc main() {\n\tclient := openai.NewClient(\n\t\toption.WithAdminAPIKey(\"My Admin API Key\"),\n\t)\n\tpage, err := client.Admin.Organization.AdminAPIKeys.List(context.TODO(), openai.AdminOrganizationAdminAPIKeyListParams{})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", page)\n}\n"
java: "package com.openai.example;\n\nimport com.openai.client.OpenAIClient;\nimport com.openai.client.okhttp.OpenAIOkHttpClient;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyListPage;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyListParams;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n OpenAIClient client = OpenAIOkHttpClient.fromEnv();\n\n AdminApiKeyListPage page = client.admin().organization().adminApiKeys().list();\n }\n}"
ruby: 'require "openai"
openai = OpenAI::Client.new(admin_api_key: "My Admin API Key")
page = openai.admin.organization.admin_api_keys.list
puts(page)'
response: "{\n \"object\": \"list\",\n \"data\": [\n {\n \"object\": \"organization.admin_api_key\",\n \"id\": \"key_abc\",\n \"name\": \"Main Admin Key\",\n \"redacted_value\": \"sk-admin...def\",\n \"created_at\": 1711471533,\n \"last_used_at\": 1711471534,\n \"owner\": {\n \"type\": \"service_account\",\n \"object\": \"organization.service_account\",\n \"id\": \"sa_456\",\n \"name\": \"My Service Account\",\n \"created_at\": 1711471533,\n \"role\": \"member\"\n }\n }\n ],\n \"first_id\": \"key_abc\",\n \"last_id\": \"key_abc\",\n \"has_more\": false\n}\n"
tags:
- Organization
post:
security:
- AdminApiKeyAuth: []
summary: Create an organization admin API key
operationId: admin-api-keys-create
description: Create a new admin-level API key for the organization.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
example: New Admin Key
responses:
'200':
description: The newly created admin API key.
content:
application/json:
schema:
$ref: '#/components/schemas/AdminApiKeyCreateResponse'
x-oaiMeta:
name: Create admin API key
group: administration
examples:
request:
curl: "curl -X POST https://api.openai.com/v1/organization/admin_api_keys \\\n -H \"Authorization: Bearer $OPENAI_ADMIN_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"New Admin Key\"\n }'\n"
node.js: "import OpenAI from 'openai';\n\nconst client = new OpenAI({\n adminAPIKey: process.env['OPENAI_ADMIN_KEY'], // This is the default and can be omitted\n});\n\nconst adminAPIKey = await client.admin.organization.adminAPIKeys.create({ name: 'New Admin Key' });\n\nconsole.log(adminAPIKey);"
python: "import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n admin_api_key=os.environ.get(\"OPENAI_ADMIN_KEY\"), # This is the default and can be omitted\n)\nadmin_api_key = client.admin.organization.admin_api_keys.create(\n name=\"New Admin Key\",\n)\nprint(admin_api_key)"
go: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/openai/openai-go\"\n\t\"github.com/openai/openai-go/option\"\n)\n\nfunc main() {\n\tclient := openai.NewClient(\n\t\toption.WithAdminAPIKey(\"My Admin API Key\"),\n\t)\n\tadminAPIKey, err := client.Admin.Organization.AdminAPIKeys.New(context.TODO(), openai.AdminOrganizationAdminAPIKeyNewParams{\n\t\tName: \"New Admin Key\",\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", adminAPIKey)\n}\n"
java: "package com.openai.example;\n\nimport com.openai.client.OpenAIClient;\nimport com.openai.client.okhttp.OpenAIOkHttpClient;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyCreateParams;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyCreateResponse;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n OpenAIClient client = OpenAIOkHttpClient.fromEnv();\n\n AdminApiKeyCreateParams params = AdminApiKeyCreateParams.builder()\n .name(\"New Admin Key\")\n .build();\n AdminApiKeyCreateResponse adminApiKey = client.admin().organization().adminApiKeys().create(params);\n }\n}"
ruby: 'require "openai"
openai = OpenAI::Client.new(admin_api_key: "My Admin API Key")
admin_api_key = openai.admin.organization.admin_api_keys.create(name: "New Admin Key")
puts(admin_api_key)'
response: "{\n \"object\": \"organization.admin_api_key\",\n \"id\": \"key_xyz\",\n \"name\": \"New Admin Key\",\n \"redacted_value\": \"sk-admin...xyz\",\n \"created_at\": 1711471533,\n \"last_used_at\": 1711471534,\n \"owner\": {\n \"type\": \"user\",\n \"object\": \"organization.user\",\n \"id\": \"user_123\",\n \"name\": \"John Doe\",\n \"created_at\": 1711471533,\n \"role\": \"owner\"\n },\n \"value\": \"sk-admin-1234abcd\"\n}\n"
tags:
- Organization
/organization/admin_api_keys/{key_id}:
get:
security:
- AdminApiKeyAuth: []
summary: Retrieve a single organization API key
operationId: admin-api-keys-get
description: Get details for a specific organization API key by its ID.
parameters:
- in: path
name: key_id
required: true
schema:
type: string
description: The ID of the API key.
responses:
'200':
description: Details of the requested API key.
content:
application/json:
schema:
$ref: '#/components/schemas/AdminApiKey'
x-oaiMeta:
name: Retrieve admin API key
group: administration
examples:
request:
curl: "curl https://api.openai.com/v1/organization/admin_api_keys/key_abc \\\n -H \"Authorization: Bearer $OPENAI_ADMIN_KEY\" \\\n -H \"Content-Type: application/json\"\n"
node.js: "import OpenAI from 'openai';\n\nconst client = new OpenAI({\n adminAPIKey: process.env['OPENAI_ADMIN_KEY'], // This is the default and can be omitted\n});\n\nconst adminAPIKey = await client.admin.organization.adminAPIKeys.retrieve('key_id');\n\nconsole.log(adminAPIKey.id);"
python: "import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n admin_api_key=os.environ.get(\"OPENAI_ADMIN_KEY\"), # This is the default and can be omitted\n)\nadmin_api_key = client.admin.organization.admin_api_keys.retrieve(\n \"key_id\",\n)\nprint(admin_api_key.id)"
go: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/openai/openai-go\"\n\t\"github.com/openai/openai-go/option\"\n)\n\nfunc main() {\n\tclient := openai.NewClient(\n\t\toption.WithAdminAPIKey(\"My Admin API Key\"),\n\t)\n\tadminAPIKey, err := client.Admin.Organization.AdminAPIKeys.Get(context.TODO(), \"key_id\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", adminAPIKey.ID)\n}\n"
java: "package com.openai.example;\n\nimport com.openai.client.OpenAIClient;\nimport com.openai.client.okhttp.OpenAIOkHttpClient;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKey;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyRetrieveParams;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n OpenAIClient client = OpenAIOkHttpClient.fromEnv();\n\n AdminApiKey adminApiKey = client.admin().organization().adminApiKeys().retrieve(\"key_id\");\n }\n}"
ruby: 'require "openai"
openai = OpenAI::Client.new(admin_api_key: "My Admin API Key")
admin_api_key = openai.admin.organization.admin_api_keys.retrieve("key_id")
puts(admin_api_key)'
response: "{\n \"object\": \"organization.admin_api_key\",\n \"id\": \"key_abc\",\n \"name\": \"Main Admin Key\",\n \"redacted_value\": \"sk-admin...xyz\",\n \"created_at\": 1711471533,\n \"last_used_at\": 1711471534,\n \"owner\": {\n \"type\": \"user\",\n \"object\": \"organization.user\",\n \"id\": \"user_123\",\n \"name\": \"John Doe\",\n \"created_at\": 1711471533,\n \"role\": \"owner\"\n }\n}\n"
tags:
- Organization
delete:
security:
- AdminApiKeyAuth: []
summary: Delete an organization admin API key
operationId: admin-api-keys-delete
description: Delete the specified admin API key.
parameters:
- in: path
name: key_id
required: true
schema:
type: string
description: The ID of the API key to be deleted.
responses:
'200':
description: Confirmation that the API key was deleted.
content:
application/json:
schema:
type: object
properties:
id:
type: string
example: key_abc
object:
type: string
enum:
- organization.admin_api_key.deleted
example: organization.admin_api_key.deleted
x-stainless-const: true
deleted:
type: boolean
example: true
required:
- id
- object
- deleted
x-oaiMeta:
name: Delete admin API key
group: administration
examples:
request:
curl: "curl -X DELETE https://api.openai.com/v1/organization/admin_api_keys/key_abc \\\n -H \"Authorization: Bearer $OPENAI_ADMIN_KEY\" \\\n -H \"Content-Type: application/json\"\n"
node.js: "import OpenAI from 'openai';\n\nconst client = new OpenAI({\n adminAPIKey: process.env['OPENAI_ADMIN_KEY'], // This is the default and can be omitted\n});\n\nconst adminAPIKey = await client.admin.organization.adminAPIKeys.delete('key_id');\n\nconsole.log(adminAPIKey.id);"
python: "import os\nfrom openai import OpenAI\n\nclient = OpenAI(\n admin_api_key=os.environ.get(\"OPENAI_ADMIN_KEY\"), # This is the default and can be omitted\n)\nadmin_api_key = client.admin.organization.admin_api_keys.delete(\n \"key_id\",\n)\nprint(admin_api_key.id)"
go: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/openai/openai-go\"\n\t\"github.com/openai/openai-go/option\"\n)\n\nfunc main() {\n\tclient := openai.NewClient(\n\t\toption.WithAdminAPIKey(\"My Admin API Key\"),\n\t)\n\tadminAPIKey, err := client.Admin.Organization.AdminAPIKeys.Delete(context.TODO(), \"key_id\")\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", adminAPIKey.ID)\n}\n"
java: "package com.openai.example;\n\nimport com.openai.client.OpenAIClient;\nimport com.openai.client.okhttp.OpenAIOkHttpClient;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyDeleteParams;\nimport com.openai.models.admin.organization.adminapikeys.AdminApiKeyDeleteResponse;\n\npublic final class Main {\n private Main() {}\n\n public static void main(String[] args) {\n OpenAIClient client = OpenAIOkHttpClient.fromEnv();\n\n AdminApiKeyDeleteResponse adminApiKey = client.admin().organization().adminApiKeys().delete(\"key_id\");\n }\n}"
ruby: 'require "openai"
openai = OpenAI::Client.new(admin_api_key: "My Admin API Key")
admin_api_key = openai.admin.organization.admin_api_keys.delete("key_id")
puts(admin_api_key)'
response: "{\n \"id\": \"key_abc\",\n \"object\": \"organization.admin_api_key.deleted\",\n \"deleted\": true\n}\n"
tags:
- Organization
components:
schemas:
AdminApiKey:
type: object
description: Represents an individual Admin API key in an org.
properties:
object:
type: string
enum:
- organization.admin_api_key
description: The object type, which is always `organization.admin_api_key`
x-stainless-const: true
id:
type: string
example: key_abc
description: The identifier, which can be referenced in API endpoints
name:
anyOf:
- type: string
- type: 'null'
example: Administration Key
description: The name of the API key
redacted_value:
type: string
example: sk-admin...def
description: The redacted value of the API key
created_at:
type: integer
format: unixtime
example: 1711471533
description: The Unix timestamp (in seconds) of when the API key was created
last_used_at:
anyOf:
- type: integer
format: unixtime
example: 1711471534
description: The Unix timestamp (in seconds) of when the API key was last used
- type: 'null'
owner:
type: object
properties:
type:
type: string
example: user
description: Always `user`
object:
type: string
example: organization.user
description: The object type, which is always organization.user
id:
type: string
example: sa_456
description: The identifier, which can be referenced in API endpoints
name:
type: string
example: My Service Account
description: The name of the user
created_at:
type: integer
format: unixtime
example: 1711471533
description: The Unix timestamp (in seconds) of when the user was created
role:
type: string
example: owner
description: Always `owner`
required:
- object
- redacted_value
- created_at
- id
- owner
x-oaiMeta:
name: The admin API key object
example: "{\n \"object\": \"organization.admin_api_key\",\n \"id\": \"key_abc\",\n \"name\": \"Main Admin Key\",\n \"redacted_value\": \"sk-admin...xyz\",\n \"created_at\": 1711471533,\n \"last_used_at\": 1711471534,\n \"owner\": {\n \"type\": \"user\",\n \"object\": \"organization.user\",\n \"id\": \"user_123\",\n \"name\": \"John Doe\",\n \"created_at\": 1711471533,\n \"role\": \"owner\"\n }\n}\n"
AdminApiKeyCreateResponse:
allOf:
- $ref: '#/components/schemas/AdminApiKey'
- type: object
description: The newly created admin API key. The `value` field is only returned once, when the key is created.
properties:
value:
type: string
example: sk-admin-1234abcd
description: The value of the API key. Only shown on create.
required:
- value
ApiKeyList:
type: object
properties:
object:
type: string
enum:
- list
example: list
x-stainless-const: true
data:
type: array
items:
$ref: '#/components/schemas/AdminApiKey'
has_more:
type: boolean
example: false
first_id:
anyOf:
- type: string
- type: 'null'
example: key_abc
last_id:
anyOf:
- type: string
- type: 'null'
example: key_xyz
required:
- object
- data
- has_more
securitySchemes:
ApiKeyAuth:
type: http
scheme: bearer
AdminApiKeyAuth:
type: http
scheme: bearer
x-oaiMeta:
navigationGroups:
- id: responses
title: Responses API
- id: webhooks
title: Webhooks
- id: endpoints
title: Platform APIs
- id: vector_stores
title: Vector stores
- id: chatkit
title: ChatKit
beta: true
- id: containers
title: Containers
- id: realtime
title: Realtime
- id: chat
title: Chat Completions
- id: assistants
title: Assistants
deprecated: true
- id: administration
title: Administration
- id: legacy
title: Legacy
groups:
- id: responses-streaming
title: Streaming events
description: 'When you [create a Response](/docs/api-reference/responses/create) with
`stream` set to `true`, the server will emit server-sent events to the
client as the Response is generated. This section contains the events that
are emitted by the server.
[Learn more about streaming responses](/docs/guides/streaming-responses?api-mode=responses).
'
navigationGroup: responses
sections:
- type: object
key: ResponseCreatedEvent
path: <auto>
- type: object
key: ResponseInProgressEvent
path: <auto>
- type: object
key: ResponseCompletedEvent
path: <auto>
- type: object
key: ResponseFailedEvent
path: <auto>
- type: object
key: ResponseIncompleteEvent
path: <auto>
- type: object
key: ResponseOutputItemAddedEvent
path: <auto>
- type: object
key: ResponseOutputItemDoneEvent
path: <auto>
- type: object
key: ResponseContentPartAddedEvent
path: <auto>
- type: object
key: ResponseContentPartDoneEvent
path: <auto>
- type: object
key: ResponseTextDeltaEvent
path: response/output_text/delta
- type: object
key: ResponseTextDoneEvent
path: response/output_text/done
- type: object
key: ResponseRefusalDeltaEvent
path: <auto>
- type: object
key: ResponseRefusalDoneEvent
path: <auto>
- type: object
key: ResponseFunctionCallArgumentsDeltaEvent
path: <auto>
- type: object
key: ResponseFunctionCallArgumentsDoneEvent
path: <auto>
- type: object
key: ResponseFileSearchCallInProgressEvent
path: <auto>
- type: object
key: ResponseFileSearchCallSearchingEvent
path: <auto>
- type: object
key: ResponseFileSearchCallCompletedEvent
path: <auto>
- type: object
key: ResponseWebSearchCallInProgressEvent
path: <auto>
- type: object
key: ResponseWebSearchCallSearchingEvent
path: <auto>
- type: object
key: ResponseWebSearchCallCompletedEvent
path: <auto>
- type: object
key: ResponseReasoningSummaryPartAddedEvent
path: <auto>
- type: object
key: ResponseReasoningSummaryPartDoneEvent
path: <auto>
- type: object
key: ResponseReasoningSummaryTextDeltaEvent
path: <auto>
- type: object
key: ResponseReasoningSummaryTextDoneEvent
path: <auto>
- type: object
key: ResponseReasoningTextDeltaEvent
path: <auto>
- type: object
key: ResponseReasoningTextDoneEvent
path: <auto>
- type: object
key: ResponseImageGenCallCompletedEvent
path: <auto>
- type: object
key: ResponseImageGenCallGeneratingEvent
path: <auto>
- type: object
key: ResponseImageGenCallInProgressEvent
path: <auto>
- type: object
key: ResponseImageGenCallPartialImageEvent
path: <auto>
- type: object
key: ResponseMCPCallArgumentsDeltaEvent
path: <auto>
- type: object
key: ResponseMCPCallArgumentsDoneEvent
path: <auto>
- type: object
key: ResponseMCPCallCompletedEvent
path: <auto>
- type: object
key: ResponseMCPCallFailedEvent
path: <auto>
- type: object
key: ResponseMCPCallInProgressEvent
path: <auto>
- type: object
key: ResponseMCPListToolsCompletedEvent
path: <auto>
- type: object
key: ResponseMCPListToolsFailedEvent
path: <auto>
- type: object
key: ResponseMCPListToolsInProgressEvent
path: <auto>
- type: object
key: ResponseCodeInterpreterCallInProgressEvent
path: <auto>
- type: object
key: ResponseCodeInterpreterCallInterpretingEvent
path: <auto>
- type: object
key: ResponseCodeInterpreterCallCompletedEvent
path: <auto>
- type: object
key: ResponseCodeInterpreterCallCodeDeltaEvent
path: <auto>
- type: object
key: ResponseCodeInterpreterCallCodeDoneEvent
path: <auto>
- type: object
key: ResponseOutputTextAnnotationAddedEvent
path: <auto>
- type: object
key: ResponseQueuedEvent
path: <auto>
- type: object
key: ResponseCustomToolCallInputDeltaEvent
path: <auto>
- type: object
key: ResponseCustomToolCallInputDoneEvent
path: <auto>
- type: object
key: ResponseErrorEvent
path: <auto>
- id: webhook-events
title: Webhook Events
description: 'Webhooks are HTTP requests sent by OpenAI to a URL you specify when certain
events happen during the course of API usage.
[Learn more about webhooks](/docs/guides/webhooks).
'
navigationGroup: webhooks
sections:
- type: object
key: WebhookResponseCompleted
path: <auto>
- type: object
key: WebhookResponseCancelled
path: <auto>
- type: object
key: WebhookResponseFailed
path: <auto>
- type: object
key: WebhookResponseIncomplete
path: <auto>
- type: object
key: WebhookBatchCompleted
path: <auto>
- type: object
key: WebhookBatchCancelled
path: <auto>
- type: object
key: WebhookBatchExpired
path: <auto>
- type: object
key: WebhookBatchFailed
path: <auto>
- type: object
key: WebhookFineTuningJobSucceeded
path: <auto>
- type: object
key: WebhookFineTuningJobFailed
path: <auto>
- type: object
key: WebhookFineTuningJobCancelled
path: <auto>
- type: object
key: WebhookEvalRunSucceeded
path: <auto>
- type: object
key: WebhookEvalRunFailed
path: <auto>
- type: object
key: WebhookEvalRunCanceled
path: <auto>
- type: object
key: WebhookRealtimeCallIncoming
path: <auto>
- id: images-streaming
title: Image Streaming
description: 'Stream image generation and editing in real time with server-sent events.
[Learn more about image streaming](/docs/guides/image-generation).
'
navigationGroup: endpoints
sections:
- type: object
key: ImageGenPartialImageEvent
path: <auto>
- type: object
key: ImageGenCompletedEvent
path: <auto>
- type: object
key: ImageEditPartialImageEvent
path: <auto>
- type: object
key: ImageEditCompletedEvent
path: <auto>
- id: realtime-client-events
title: Client events
description: 'These are events that the OpenAI Realtime WebSocket server will accept from the client.
'
navigationGroup: realtime
sections:
- type: object
key: RealtimeClientEventSessionUpdate
path: <auto>
- type: object
key: RealtimeClientEventInputAudioBufferAppend
path: <auto>
- type: object
key: RealtimeClientEventInputAudioBufferCommit
path: <auto>
- type: object
key: RealtimeClientEventInputAudioBufferClear
path: <auto>
- type: object
key: RealtimeClientEventConversationItemCreate
path: <auto>
- type: object
key: RealtimeClientEventConversationItemRetrieve
path: <auto>
- type: object
key: RealtimeClientEventConversationItemTruncate
path: <auto>
- type: object
key: RealtimeClientEventConversationItemDelete
path: <auto>
- type: object
key: RealtimeClientEventResponseCreate
path: <auto>
- type: object
key: RealtimeClientEventResponseCancel
path: <auto>
- type: object
key: RealtimeClientEventOutputAudioBufferClear
path: <auto>
- id: realtime-server-events
title: Server events
description: 'These are events emitted from the OpenAI Realtime WebSocket server to the client.
'
navigationGroup: realtime
sections:
- type: object
key: RealtimeServerEventError
path: <auto>
- type: object
key: RealtimeServerEventSessionCreated
path: <auto>
- type: object
key: RealtimeServerEventSessionUpdated
path: <auto>
- type: object
key: RealtimeServerEventConversationItemAdded
path: <auto>
- type: object
key: RealtimeServerEventConversationItemDone
path: <auto>
- type: object
key: RealtimeServerEventConversationItemRetrieved
path: <auto>
- type: object
key: RealtimeServerEventConversationItemInputAudioTranscriptionCompleted
path: <auto>
- type: object
key: RealtimeServerEventConversationItemInputAudioTranscriptionDelta
path: <auto>
- type: object
key: RealtimeServerEventConversationItemInputAudioTranscriptionSegment
path: <auto>
- type: object
key: RealtimeServerEventConversationItemInputAudioTranscriptionFailed
path: <auto>
- type: object
key: RealtimeServerEventConversationItemTruncated
path: <auto>
- type: object
key: RealtimeServerEventConversationItemDeleted
path: <auto>
- type: object
key: RealtimeServerEventInputAudioBufferCommitted
path: <auto>
- type: object
key: RealtimeServerEventInputAudioBufferDtmfEventReceived
path: <auto>
- type: object
key: RealtimeServerEventInputAudioBufferCleared
path: <auto>
- type: object
key: RealtimeServerEventInputAudioBufferSpeechStarted
path: <auto>
- type: object
key: RealtimeServerEventInputAudioBufferSpeechStopped
path: <auto>
- type: object
key: RealtimeServerEventInputAudioBufferTimeoutTriggered
path: <auto>
- type: object
key: RealtimeServerEventOutputAudioBufferStarted
path: <auto>
- type: object
key: RealtimeServerEventOutputAudioBufferStopped
path: <auto>
- type: object
key: RealtimeServerEventOutputAudioBufferCleared
path: <auto>
- type: object
key: RealtimeServerEventResponseCreated
path: <auto>
- type: object
key: RealtimeServerEventResponseDone
path: <auto>
- type: object
key: RealtimeServerEventResponseOutputItemAdded
path: <auto>
- type: object
key: RealtimeServerEventResponseOutputItemDone
path: <auto>
- type: object
key: RealtimeServerEventResponseContentPartAdded
path: <auto>
- type: object
key: RealtimeServerEventResponseContentPartDone
path: <auto>
- type: object
key: RealtimeServerEventResponseTextDelta
path: <auto>
- type: object
key: RealtimeServerEventResponseTextDone
path: <auto>
- type: object
key: RealtimeServerEventResponseAudioTranscriptDelta
path: <auto>
- type: object
key: RealtimeServerEventResponseAudioTranscriptDone
path: <auto>
- type: object
key: RealtimeServerEventResponseAudioDelta
path: <auto>
- type: object
key: RealtimeServerEventResponseAudioDone
path: <auto>
- type: object
key: RealtimeServerEventResponseFunctionCallArgumentsDelta
path: <auto>
- type: object
key: RealtimeServerEventResponseFunctionCallArgumentsDone
path: <auto>
- type: object
key: RealtimeServerEventResponseMCPCallArgumentsDelta
path: <auto>
- type: object
key: RealtimeServerEventResponseMCPCallArgumentsDone
path: <auto>
- type: object
key: RealtimeServerEventResponseMCPCallInProgress
path: <auto>
- type: object
key: RealtimeServerEventResponseMCPCallCompleted
path: <auto>
- type: object
key: RealtimeServerEventResponseMCPCallFailed
path: <auto>
- type: object
key: RealtimeServerEventMCPListToolsInProgress
path: <auto>
- type: object
key: RealtimeServerEventMCPListToolsCompleted
path: <auto>
- type: object
key: RealtimeServerEventMCPListToolsFailed
path: <auto>
- type: object
key: RealtimeServerEventRateLimitsUpdated
path: <auto>
- id: realtime-translation-client-events
title: Translation client events
description: 'These are events that the OpenAI Realtime Translation WebSocket server will accept from the client.
'
navigationGroup: realtime
sections:
- type: object
key: RealtimeTranslationClientEventSessionUpdate
path: <auto>
- type: object
key: RealtimeTranslationClientEventInputAudioBufferAppend
path: <auto>
- type: object
key: RealtimeTranslationClientEventSessionClose
path: <auto>
- id: realtime-translation-server-events
title: Translation server events
description: 'These are events emitted from the OpenAI Realtime Translation WebSocket server to the client.
'
navigationGroup: realtime
sections:
- type: object
key: RealtimeServerEventError
path: <auto>
- type: object
key: RealtimeTranslationServerEventSessionCreated
path: <auto>
- type: object
key: RealtimeTranslationServerEventSessionUpdated
path: <auto>
- type: object
key: RealtimeTranslationServerEventSessionClosed
path: <auto>
- type: obje
# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-organization-api-openapi.yml