Skip to main content
POST
Create response

Authorizations

Authorization
string
header
required

API key for programmatic access (Authorization: Bearer sk-<api_key>)

Body

application/json

OpenAPI-only view of the stateless Responses request contract.

The runtime request type keeps legacy variants so it can return a precise invalid_request_error for them. The public endpoint schema should instead show only the items accepted by the stateless implementation.

model
string
required
include
string[] | null
input
instructions
string | null
max_output_tokens
integer<int64> | null
max_tool_calls
integer<int64> | null
metadata
any
parallel_tool_calls
boolean | null
prompt_cache_key
string | null
reasoning
null | object

Reasoning configuration

safety_identifier
string | null
service_tier
string | null
store
boolean
default:false

Must be false when supplied; omitted is normalized to false.

Example:

false

stream
boolean | null
temperature
number<float> | null
tool_choice

Tool choice configuration

tools
object[] | null
top_p
number<float> | null

Response

Response created

Complete response object

created_at
integer<int64>
required
id
string
required
model
string
required
object
string
required
output
object[]
required

Output item from response

parallel_tool_calls
boolean
required
status
enum<string>
required
Available options:
completed,
failed,
in_progress,
cancelled,
queued,
incomplete
store
boolean
required
temperature
number<float>
required
tool_choice
required
tools
object[]
required
top_p
number<float>
required
usage
object
required
background
boolean
conversation
null | object

Conversation reference in response object

error
null | object
incomplete_details
null | object
instructions
string | null
max_output_tokens
integer<int64> | null
max_tool_calls
integer<int64> | null
metadata
any
next_response_ids
string[]
previous_response_id
string | null
prompt_cache_key
string | null
prompt_cache_retention
string | null
reasoning
null | object
safety_identifier
string | null
service_tier
string
top_logprobs
integer<int32>
truncation
string
user
string | null