Operations

API endpoints available to AI agents

**Starting a new project?** We recommend trying [Responses](/docs/api-reference/responses) to take advantage of the latest OpenAI platform features. Compare [Chat Completions with Responses](/docs/guides/responses-vs-chat-completions?api-mode=responses). --- Creates a model response for the given chat conversation. Learn more in the [text generation](/docs/guides/text-generation), [vision](/docs/guides/vision), and [audio](/docs/guides/audio) guides. Parameter support can differ depending on the model used to generate the response, particularly for newer reasoning models. Parameters that are only supported for reasoning models are noted below. For the current state of unsupported parameters in reasoning models, [refer to the reasoning guide](/docs/guides/reasoning).

createChatCompletion

POST/chat/completions

Chat

Delete a stored chat completion. Only Chat Completions that have been created with the `store` parameter set to `true` can be deleted.

deleteChatCompletion

DELETE/chat/completions/{completion_id}

Chat

Get a stored chat completion. Only Chat Completions that have been created with the `store` parameter set to `true` will be returned.

getChatCompletion

GET/chat/completions/{completion_id}

Chat

Get the messages in a stored chat completion. Only Chat Completions that have been created with the `store` parameter set to `true` will be returned.

getChatCompletionMessages

GET/chat/completions/{completion_id}/messages

Chat

List stored Chat Completions. Only Chat Completions that have been stored with the `store` parameter set to `true` will be returned.

listChatCompletions

GET/chat/completions

Chat

Modify a stored chat completion. Only Chat Completions that have been created with the `store` parameter set to `true` can be modified. Currently, the only supported modification is to update the `metadata` field.

updateChatCompletion

POST/chat/completions/{completion_id}

Chat