Skip to main content
GET
Read durable run trace

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
required

Query Parameters

cursor
string
limit
integer
default:100
Required range: 1 <= x <= 200
eventTypes
string[]
Maximum array length: 20
Maximum string length: 100
includePayloads
boolean
default:false
payloadMaxChars
integer
Required range: 1600 <= x <= 20000

Response

A durable trace page. Payloads, when requested, remain bounded and redacted.

runId
string
required
status
string
required

Persisted execution status; may differ from the public polling status.

events
object[]
required
pagination
object
required
replayContract
object
required