Skip to main content
Pause a sandbox and keep it

Authorizations

Authorization
string
header
required

BoxRouter API key; never an upstream provider key.

Headers

Idempotency-Key
string

Optional for this operation. Preserve the same stable identifier when retrying an uncertain response; never reuse it for new work. If omitted where allowed, Cloud generates a request-scoped key that cannot reconcile a later retry. Do not include credentials or payloads. Stable identifier for one logical mutation.

Required string length: 1 - 128

Path Parameters

sandbox_id
string
required

Workspace-owned BoxRouter sandbox ID, not an upstream ID.

Minimum string length: 1
Pattern: ^[^\u0000]*$

Response

The pause result.

state
enum<string>
required
Available options:
paused
keeps
enum<string>
required
Available options:
files_only,
files_and_memory
outside_grant
enum<string>[]
required

Observed values that fell outside the pause_resume grant.

Available options:
keeps
lifetime
object
required

How long the sandbox may live. It counts from the provider's create, as with the provider's own SDK (BoxRouter's clock starts when it sends the create). Whether paused time counts depends on the provider.

pause_expires_at
string<date-time> | null

Deadline after which a managed paused sandbox is terminated; null when no managed pause deadline applies.