v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
agent

Complete Agent Run

Handle sandbox completion callbacks for autonomous agent runs.

Args: agent_run_id: Agent run identifier from the path. payload: Completion payload from the sandbox. callback_token: One-time callback authentication token. execution_service: Agent execution service.

Returns: Callback acceptance response including resulting run status.

Raises: HTTPException: When callback auth fails or run is missing.

post/agent/runs/{agent_run_id}/complete

Path parameters

agent_run_idstring required

Headers

X-Agent-Callback-Tokenstring required

Request body

status'completed' | 'failed' required
deliverablesobject nullable
data_curation_reportstring nullable
final_reportstring nullable
system_deficienciesstring nullable
error_messagestring nullable
llm_token_usageobject[] nullable

Response

Successful Response

agent_run_idstring required
statusstring required
acceptedboolean required