Documentation

Responses

responses

Methods

Responses ->
OpenAIResponse
| { delta, sequence_number, type } | { sequence_number, type } | 52 more...
post/v5/responses

Responses

Domain types

ApplyPatchCall = { call_id, operation, status, 2 more... }

A tool call representing a request to create, delete, or update files using diff patches.

ApplyPatchCallOutput = { call_id, status, type, 2 more... }

The streamed output emitted by an apply patch tool call.

ApplyPatchTool = { type }

Allows the assistant to create, delete, or update files using unified diffs.

ComputerTool = { display_height, display_width, environment, 1 more... }

A tool that controls a virtual computer.

Learn more about the computer tool.

ContainerNetworkPolicyAllowlist = { allowed_domains, type, domain_secrets }
ContainerNetworkPolicyDisabled = { type }
ContainerReference = { container_id, type }
ContainerReferenceParam = { container_id, type }
Conversation = { id }

The conversation that this response belonged to.

Input items and output items from this response were automatically added to this conversation.

CustomTool = { name, type, description, 1 more... }

A custom tool that processes input using a specified format.

Learn more about custom tools

EasyInputMessage = { content, role, phase, 1 more... }

A message input to the model with a role indicating instruction following hierarchy. Instructions given with the developer or system role take precedence over instructions given with the user role. Messages with the assistant role are presumed to have been generated by the model in previous interactions.

FileSearchTool = { type, vector_store_ids, filters, 2 more... }

A tool that searches for relevant content from uploaded files.

Learn more about the file search tool.

FunctionShellTool = { type, environment }

A tool that allows the model to execute shell commands.

FunctionTool = { name, type, description, 2 more... }

Defines a function in your own code the model can choose to call.

Learn more about function calling.

IncompleteDetails = { reason }

Details about why the response is incomplete.

LocalEnvironment = { type, skills }
LocalEnvironmentParam = { type, skills }
McpApprovalRequest = { id, arguments, name, 2 more... }

A request for human approval of a tool invocation.

OpenAIResponse = { id, created_at, model, 29 more... }
OpenAIResponseCodeInterpreterToolCall = { id, container_id, status, 3 more... }

A tool call to run code.

OpenAIResponseComputerToolCall = { id, action, call_id, 3 more... }

A tool call to a computer use tool.

See the computer use guide for more information.

OpenAIResponseCustomToolCall = { call_id, input, name, 2 more... }

A call to a custom tool created by the model.

OpenAIResponseCustomToolCallOutput = { call_id, output, type, 1 more... }

The output of a custom tool call from your code, being sent back to the model.

OpenAIResponseError = { code, message }

An error object returned when the model fails to generate a Response.

OpenAIResponseFileSearchToolCall = { id, queries, status, 2 more... }

The results of a file search tool call.

See the file search guide for more information.

OpenAIResponseFunctionToolCall = { arguments, call_id, name, 3 more... }

A tool call to run a function.

See the function calling guide for more information.

OpenAIResponseFunctionWebSearch = { id, action, status, 1 more... }

The results of a web search tool call.

See the web search guide for more information.

OpenAIResponseInputFile = { type, file_data, file_id, 2 more... }

A file input to the model.

OpenAIResponseInputFileParam = { type, file_data, file_id, 2 more... }

A file input to the model.

OpenAIResponseInputImage = { detail, type, file_id, 1 more... }

An image input to the model.

Learn about image inputs.

OpenAIResponseInputImageParam = { detail, type, file_id, 1 more... }

An image input to the model.

Learn about image inputs.

OpenAIResponseInputText = { text, type }

A text input to the model.

OpenAIResponseInputTextParam = { text, type }

A text input to the model.

OpenAIResponseOutputMessage = { id, content, role, 3 more... }

An output message from the model.

OpenAIResponseOutputRefusal = { refusal, type }

A refusal from the model.

OpenAIResponseOutputText = { annotations, text, type, 1 more... }

A text output from the model.

OpenAIResponsePrompt = { id, variables, version }

Reference to a prompt template and its variables. Learn more.

OpenAIResponseReasoningItem = { id, summary, type, 3 more... }

A description of the chain of thought used by a reasoning model while generating a response. Be sure to include these items in your input to the Responses API for subsequent turns of a conversation if you are manually managing context.

OpenAIResponseTextConfig = { format, verbosity }

Configuration options for a text response from the model.

Can be plain text or structured JSON data. Learn more:

OpenAIResponseUsage = { input_tokens, input_tokens_details, output_tokens, 2 more... }

Represents token usage details including input tokens, output tokens, a breakdown of output tokens, and the total tokens used.

OpenAITypesResponsesResponseInputItemComputerCallOutput = { call_id, output, type, 3 more... }

The output of a computer tool call.

OpenAITypesResponsesResponseInputItemFunctionCallOutput = { call_id, output, type, 2 more... }

The output of a function tool call.

OpenAITypesResponsesResponseInputItemImageGenerationCall = { id, status, type, 1 more... }

An image generation request made by the model.

OpenAITypesResponsesResponseInputItemItemReference = { id, type }

An internal identifier for an item to reference.

OpenAITypesResponsesResponseInputItemLocalShellCall = { id, action, call_id, 2 more... }

A tool call to run a command on the local shell.

OpenAITypesResponsesResponseInputItemLocalShellCallOutput = { id, output, type, 1 more... }

The output of a local shell tool call.

OpenAITypesResponsesResponseInputItemMcpApprovalResponse = { approval_request_id, approve, type, 2 more... }

A response to an MCP approval request.

OpenAITypesResponsesResponseInputItemMcpCall = { id, arguments, name, 6 more... }

An invocation of a tool on an MCP server.

OpenAITypesResponsesResponseInputItemMcpListTools = { id, server_label, tools, 2 more... }

A list of tools available on an MCP server.

OpenAITypesResponsesResponseInputItemMessage = { content, role, status, 1 more... }

A message input to the model with a role indicating instruction following hierarchy. Instructions given with the developer or system role take precedence over instructions given with the user role.

OpenAITypesResponsesResponseOutputItemImageGenerationCall = { id, status, type, 1 more... }

An image generation request made by the model.

OpenAITypesResponsesResponseOutputItemLocalShellCall = { id, action, call_id, 2 more... }

A tool call to run a command on the local shell.

OpenAITypesResponsesResponseOutputItemMcpCall = { id, arguments, name, 6 more... }

An invocation of a tool on an MCP server.

OpenAITypesResponsesResponseOutputItemMcpListTools = { id, server_label, tools, 2 more... }

A list of tools available on an MCP server.

PartReasoningText = { text, type }

Reasoning text from the model.

Reasoning = { effort, generate_summary, summary }

gpt-5 and o-series models only

Configuration options for reasoning models.

ResponseApplyPatchToolCall = { id, call_id, operation, 3 more... }

A tool call that applies file diffs by creating, deleting, or updating files.

ResponseApplyPatchToolCallOutput = { id, call_id, status, 3 more... }

The output emitted by an apply patch tool call.

ResponseCompactionItem = { id, encrypted_content, type, 1 more... }

A compaction item generated by the v1/responses/compact API.

ResponseCompactionItemParam = { encrypted_content, type, id }

A compaction item generated by the v1/responses/compact API.

ResponseComputerToolCallOutputScreenshot = { type, file_id, image_url }

A computer screenshot image used with the computer use tool.

ResponseCreateResponse =
OpenAIResponse
| { delta, sequence_number, type } | { sequence_number, type } | 52 more...

Emitted when there is a partial audio response.

ResponseFunctionShellToolCall = { id, action, call_id, 4 more... }

A tool call that executes one or more shell commands in a managed environment.

ResponseFunctionShellToolCallOutput = { id, call_id, output, 4 more... }

The output of a shell tool call that was emitted.

ShellCall = { action, call_id, type, 3 more... }

A tool representing a request to execute one or more shell commands.

ShellCallOutput = { call_id, output, type, 3 more... }

The streamed output items emitted by a shell tool call.

ToolChoiceAllowed = { mode, tools, type }

Constrains the tools available to the model to a pre-defined set.

ToolChoiceApplyPatch = { type }

Forces the model to call the apply_patch tool when executing a tool call.

ToolChoiceCustom = { name, type }

Use this option to force the model to call a specific custom tool.

ToolChoiceFunction = { name, type }

Use this option to force the model to call a specific function.

ToolChoiceMcp = { server_label, type, name }

Use this option to force the model to call a specific tool on a remote MCP server.

ToolChoiceShell = { type }

Forces the model to call the shell tool when a tool call is required.

ToolChoiceTypes = { type }

Indicates that the model should use a built-in tool to generate a response. Learn more about built-in tools.

WebSearchPreviewTool = { type, search_context_size, user_location }

This tool searches the web for relevant results to use in a response.

Learn more about the web search tool.

WebSearchTool = { type, filters, search_context_size, 1 more... }

Search the Internet for sources related to the prompt.

Learn more about the web search tool.