Run

Why it matters: The universal unit of work — lets agents and humans see what happened, why, and how much it cost.

Observable execution trace for an agent: status, events, lineage, and artifact references.

GitHub issue →

API endpoints

Method	Path	Description
POST	/v1/runs	Start a run
GET	/v1/runs/:id	Get run status and events
PATCH	/v1/runs/:id	Update run status
POST	/v1/runs/:id/events	Append an event
POST	/v1/runs/:id/children	Create a child run