Connect to a sandbox
Connects to a running sandbox and returns its data-plane connection info (domain and access token). When timeout is provided and greater than 0, the call also extends the sandbox’s lifetime (extend-only, never shortens). Returns 409 if the instance is not running.
The response always returns the authoritative expiry time end_at as settled by this call — if no extension took effect (the requested expiry is not later than the current one), it is simply the unchanged current value.
The sandbox_access_token stays valid for the entire lifetime of the sandbox. When the lifetime is extended, the control plane re-signs and returns a new token; even without an extension, if the token has drifted from the sandbox’s current end_at, this endpoint repairs it.
Authorizations
API Key or Access Token, always sent as Authorization: Bearer <token>. The gateway recognizes the token type automatically.
Path Parameters
Unique sandbox resource ID (UUID; the id field of the create response). The data-plane key (sandbox_key) cannot be used here.
Body
When greater than 0, extends the lifetime of a running sandbox (extend-only, never shortens).