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, but /api/runs/:id is not part of the current public docs surface.

For public beta skill flows, start with the immediate skillRunResponseSchema fields such as output, validation, and diagnostic.

See also

• Read Run Detail
• Run Object
• Public Boundary