v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2114136159.9 KB
Responses

Retrieve a response

Retrieve a response by its ID. Use this to poll the status of background tasks.

get/v1/responses/{response_id}

Path parameters

response_idstring required

ID of the response to retrieve (e.g., resp_...).

Response

The response object

created_atinteger required
idstring required
modelstring required
object'response' required

Object type in API responses

status'completed' | 'failed' | 'in_progress' | 'queued' | 'cancelled' | 'requires_action' required

Status of a response or output item

backgroundboolean

Whether the response was created in background mode.

previous_response_idstring nullable

ID of the previous response in the chain, when the response was created with previous_response_id.

storeboolean

Whether the response is stored and visible to later retrieve calls. A response created with store=false can still be used as a previous_response_id continuation source.