Sandbox events

The events.stream() endpoint emits lifecycle and activity SSE events for a sandbox, which is useful for monitoring agent runs.

Logs, metrics, and export

Every sandbox exposes three observability surfaces:

SurfaceEndpoint
LogsGET /api/v1/sandboxes/{id}/logs
Per-sandbox metricsGET /api/v1/sandboxes/{id}/metrics
Lifecycle event streamGET /api/v1/sandboxes/{id}/events - the stream on this page

A stopped sandbox’s disk can be exported as an archive without resuming it. GET /api/v1/sandboxes/{id}/exports reads the saved disk, so it works while the sandbox is stopped and does not start compute.

Was this page helpful?