Get agent run

GET 
/api/agents/:agent_id/runs/:run_id

Retrieve a persisted workflow execution owned by the authenticated user. The run must belong to the specified agent, and the user must still have access to that agent. Unknown runs, runs owned by another user, and mismatched agent/run identifiers return 404. Requires the agents.run scope. Executions without a persisted workflow record are not available through this endpoint.

Request

Responses

200

Current persisted run snapshot. A failed execution is still a successful retrieval.

400

Invalid request (malformed JSON, invalid parameter values, unknown fields).

401

Missing or invalid authentication token.

403

Token valid but lacks permission for the requested operation.

404

Resource not found.

408

Backend did not respond within the timeout window.

429

Rate limit exceeded. Includes Retry-After header.

500

Unexpected server-side failure.

503

Backend temporarily unavailable.