Remotehost Docs
API ReferenceSandboxes

Stop a sandbox

Deprecated

POST
/sandboxes/{sandboxId}/stop

Deprecated: use POST /sandboxes/{sandboxId}/sleep.

Authorization

bearerAuth
AuthorizationBearer <token>

A RemoteHost API key (rh_sk_...) or a user session token.

In: header

Path Parameters

sandboxId*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/sandboxes/string/stop"
{  "sandbox": {    "id": "string",    "org_id": "string",    "project_id": "string",    "name": "string",    "agent": "claude",    "status": "provisioning",    "mode": "persistent",    "region": "string",    "persistence_policy": "throwaway_ephemeral",    "sandbox_profile": "string",    "machine_size": "small",    "provider": "string",    "vmm": "string",    "allocated_vcpu": 0,    "allocated_memory_gb": 0,    "allocated_disk_gb": 0,    "end_user_id": "string",    "vm_lost_at": "string",    "environment_id": "string",    "disk": {      "usedBytes": 0,      "totalBytes": 0,      "availableBytes": 0,      "warning": 80,      "sampledAt": "string"    },    "created_at": "string",    "updated_at": "string"  }}

Put a sandbox to sleep POST

Snapshots the sandbox, releases its machine and ends machine-time billing. A sleeping sandbox reports status `stopped` and keeps everything for wake. An ephemeral sandbox has no snapshot to keep, so sleeping ends it.

Destroy a sandbox POST

Permanently deletes the sandbox and its retained snapshot. Sleep it instead if you intend to come back to it.