Runs

In the current public docs surface, persisted run detail means agent run detail.

Stable public run detail

• create a run with POST /api/agents/:id/run
• inspect it with GET /api/agent-runs/:id

The returned object is agentRunDetailSchema.

Public beta skill runs

POST /api/skills/:id/run returns a skillRunResponseSchema object with:

• runId
• output
• validation
• diagnostic

The API implementation also has /api/runs* orchestration routes, but those are non-public in the current docs boundary.

Why it matters

Runs are the source of truth for:

• what happened
• which version ran
• whether validation passed
• what diagnostic context was recorded

See also

• Agents
• Run Object
• Public Boundary