v

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0926150111.7 MB
Agents

Get response

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.

get/v2/agents/{agent_key}/responses/{task_id}

Path parameters

agent_keystring required

The unique key identifier of the agent

The unique key identifier of the agent

task_idstring required

The agent execution task ID returned from create response

The agent execution task ID returned from create response

Response

Response retrieved successfully. Returns the current state of the agent execution including output messages, model used, token usage, and status.

_idstring required

The unique response ID

task_idstring required

The agent execution task ID

created_atstring required

ISO timestamp of response creation

modelstring required

Model used in provider/model format

finish_reason'stop' | 'length' | 'tool_calls' | 'content_filter' | 'function_call' | 'max_iterations' | 'max_time'

The reason why the agent stopped generating

status'in_progress' | 'completed' | 'failed' required

Current status of the agent response

errorstring

Error message when status is failed