GET /sandbox/{id}/status in a loop waiting for a pod to come up or a command to finish.
Events
Sandbox lifecycle
Command execution
Files and artifacts
Checkpoints
Resources and security
Subscribe
Subscribe to specific events, or to"*" for all of them. Give a secret ā it is what lets you
verify that a delivery came from StateSet rather than from anyone who learned your URL.
The payload
Every delivery has the same envelope;data is event-specific.
id is unique per delivery and stable across retries ā use it to make your handler idempotent,
because a retry after a timeout means you may see the same delivery twice.
Verify the signature
When a subscription has asecret, every delivery carries an HMAC-SHA256 of the raw body in the
X-Webhook-Signature header, as sha256=<hex>. Verify it against the raw request body, not a
re-serialised object ā whitespace differences change the digest.
Related
- Sandbox API reference ā the status endpoints webhooks let you stop polling
- Sandbox security guide ā secrets, isolation and audit logging
- Sandbox operations