Retrieve an agent run

Principal that initiated the run. Populated with the authenticated user's identity when a session caller initiates the run, and with the account when an API key caller initiates the run. null for system-initiated runs.

Artifact envelope produced by the agent. Non-null only when status is completed; null for running, interrupted, and error runs.

Pending interrupt requests awaiting input. Empty when the run is not interrupted. To resume a run, POST the interrupt's id along with the caller-supplied input to POST /v1/runs/{id}/resume.

Top-level execution steps for this run. Opt-in: pass ?include=steps on GET /v1/runs/{id} (or POST /v1/runs/{id}/resume) to populate this field. Omitted by default to avoid the cost of fetching step state from the underlying execution backend.