Retrieves the current state of an agent response by task ID. Returns the response output, model information, token usage, and execution status. When the agent is still processing, the output array will be empty and status will be in_progress. Once completed, the response includes the full output, usage statistics, and finish reason.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The unique key identifier of the agent
The agent execution task ID returned from create response
Response retrieved successfully. Returns the current state of the agent execution including output messages, model used, token usage, and status.
Response type from the get-response endpoint. Includes a status field indicating the current state of the agent execution.
The unique response ID
The agent execution task ID
Array of messages from the agent execution
ISO timestamp of response creation
Model used in provider/model format
Current status of the agent response
in_progress, completed, failed Token usage from the agent execution
The reason why the agent stopped generating
stop, length, tool_calls, content_filter, function_call, max_iterations, max_time Tool calls awaiting user response (when finish_reason is function_call)
Telemetry information for correlating the response with traces
Error message when status is failed