Skip to main content
PATCH
Update sandbox lifetime

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

sandbox_id
string<uuid>
required

Sandbox UUID.

Body

application/json
ttl_mode
enum<string>
required

Sandbox lifetime policy. default uses the platform’s idle and maximum lifetime limits.

Available options:
default,
duration,
always_on
ttl_hours
integer

Required when ttl_mode is duration. Number of hours before cleanup, up to 24.

Required range: x <= 24

Response

Sandbox updated.

id
string<uuid>
required
short_id
string
required
endpoint
string
required
status
enum<string>
required
Available options:
pending,
provisioning,
running,
error,
deleting
project_id
string<uuid> | null
required
access_scope
enum<string>
required
Available options:
project,
private
workspace_storage
enum<string>
required

Persistent workspaces survive runtime pod replacement. Deleting the sandbox also deletes its workspace.

Available options:
ephemeral,
persistent
ttl_mode
enum<string>
required
Available options:
default,
duration,
always_on
ttl_hours
integer | null
required
expires_at
string | null
required
created_at
string
required
last_activity_at
string | null
required
variable_snapshot
object

Snapshot provenance on sandbox details. Variables are copied once, without live synchronization. No variable keys or values are included.