Get run
Returns run status, a pending interaction when the run is waiting for user input, and the final response when the run has completed. Only the same API key that started the run may read it.
Authorizations
Workspace API key created in Erstan Settings. Keys carry scopes (agents:list, agents:read, agents:write, agents:run, runs:read, tasks:execute, documents:read, documents:write, files:read, files:write). Agent access follows the key creator's current workspace, team, and agent permissions. Agent draft creation requires agents:write; update, validation, and publishing require both agents:read and agents:write; draft testing also requires agents:run. Keys with tasks:execute must include at least one allowed project or team (allowedProjectIds / allowedTeamIds); keys with document or file scopes must include at least one allowed team. Empty allowlists mean no access — the API fails closed.
Path Parameters
Run ID returned by POST /v1/public/agents/{agentId}/runs.
Response
Run status and result.
running, cancelling, waiting, completed, failed, cancelled Final agent output when status is completed; otherwise null.
Interaction to answer when status is waiting; otherwise null.
Canonical interaction lifecycle. actionable is the only state in which pendingInteraction may be answered. retained means a resume was claimed but not yet accepted and the caller must keep polling; none means there is no current actionable interaction.
actionable, retained, none Time the durable cancellation request was first accepted.
Time the worker acknowledged terminal cancellation.