Skip to main content
POST
Hold a sandbox awake

Authorizations

Authorization
string
header
required

Personal byk_ API key; user-principal, resolved to a tenant by org context.

Headers

X-Bonya-Organization-ID
string

Org context. Omitted means the caller's personal organization. A well-formed non-member org is 404; malformed is 400.

Path Parameters

sandbox_id
string
required

Body

application/json
for
string
required

Hold duration as a Go duration, for example 30m or 2h.

Response

Hold placed

id
string
required

Sandbox id, for example sb-bpyk22c3ei3hfx.

name
string
required
organization_id
string
required
template_version
string
required
state
enum<string>
required
Available options:
creating,
running,
warm,
cooling,
cold,
waking,
deleting,
deleted,
failed,
lost
generation
integer
required
vcpus
integer
required
memory_mib
integer
required
user_layer_bytes
integer
required
created_at
string<date-time>
required
network
object
required
network_revision
integer
required
network_applied_revision
integer
required

Revision the node is known to enforce; below network_revision until a change is applied.

keepalive_until
string<date-time>
required
failure_reason
string
started_at
string<date-time>
deleted_at
string<date-time>
parent_snapshot_id
string

The named snapshot it was created from.

forked_from_sandbox_id
string
pause_source
string

Who paused it: idle, requested, memory_pressure.

image
object
gpu
object
exec_capability_jws
string

Exec capability token, present on responses that carry one.