Get automation run details
Returns run metadata and, when linked, agent conversation details.
GET
/automations/{id}/runs/{runId}Authorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:reador
AuthorizationBearer token (JWT) · headerrequiredPath parameters
idstringrequiredrunIdstringrequiredResponses
200
agentRunIdobject | nullrequiredAgent run ID when linked
agentTranscriptobjectSanitized agent transcript when agentRunId is linked (run metadata, lastSeq, events)
automationIdstringrequiredAutomation ID
causestringrequiredRun cause (triggerFired, testRun)
executionTypestringrequiredExecution type
executorUserIdstringrequiredExecutor user ID
failureKindobject | nullrequiredFailure classification (technical or agentReported) when status is failed
finishedAtobject | nullrequiredWhen execution finished
firedAtstring<date-time>requiredWhen the run was fired
idstringrequiredRun ID
metadataobjectrequiredRun metadata
requestedByUserIdobject | nullrequiredRequested by user ID
resultPayloadobject | nullrequiredStructured result payload from the agent
resultSummaryobject | nullrequiredOutcome summary reported by the agent
startedAtobject | nullrequiredWhen execution started
statusstringrequiredRun status (queued, running, done, failed, canceled)
testContextDocobject | nullrequiredOptional test context snapshot used for this run
401
Unauthorized - Invalid or missing authentication token
403
Forbidden - Insufficient API scopes or permissions