Inspect Your First Run

After POST /api/agents/:id/run, note the runId in the response.

Fetch detail

GET /api/agent-runs/:id?organizationId=<orgId>
Authorization: Bearer <accessToken or apiKey>

This route is api_key_or_access_token. API keys need runs:read.

What you see

GET /api/agent-runs/:id returns agentRunDetailSchema:

• run
• contractTrace
• validation
• diagnostic
• decisionTrace

Important boundary note

Skill runs also return a runId. For public beta skill flows, start with the immediate skillRunResponseSchema fields such as output, validation, and diagnostic, then use GET /api/skill-runs/:id when you need persisted skill-run detail.

See also

• Read Run Detail
• Run Object
• Public Boundary