Skip to main content
POST
Preview the exact guarded draft

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.

Headers

If-Match
string
required
Idempotency-Key
string
required
Required string length: 1 - 200

Path Parameters

id
string
required

Body

application/json
skillVersions
object[]
Maximum array length: 50
laneId
string
input
object
attachments
object[]

Response

Existing accepted preview.

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