Reference

Errors and limits

Build resilient integrations around actionable HTTP responses.

Use 401 for missing or invalid credentials, 403 for insufficient permissions, and 404 for a sandbox outside the current organization. Retry only transient failures, and apply bounded backoff in agent loops rather than tight retry cycles.

A sandbox without a live provider machine cannot mint data-plane access or create a snapshot. Treat this as a validation error and wait for the sandbox to be running.