Skip to main content
GET
Get run

Authorizations

Authorization
string
header
required

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

runId
string<uuid>
required

Run ID returned by POST /v1/public/agents/{agentId}/runs.

Response

Run status and result.

runId
string<uuid>
required
agentId
string
required
laneId
string | null
required
status
enum<string>
required
Available options:
running,
cancelling,
waiting,
completed,
failed,
cancelled
finalResponse
required

Final agent output when status is completed; otherwise null.

pendingInteraction
object | null
required

Interaction to answer when status is waiting; otherwise null.

interruptDisposition
enum<string>
required

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.

Available options:
actionable,
retained,
none
error
string | null
required
startedAt
string<date-time>
required
completedAt
string<date-time> | null
required
cancelRequestedAt
string<date-time> | null
required

Time the durable cancellation request was first accepted.

cancelledAt
string<date-time> | null
required

Time the worker acknowledged terminal cancellation.