Remotehost Docs
API ReferenceSandboxes

Renew an ephemeral sandbox

POST
/sandboxes/{sandboxId}/renew

Extends a running ephemeral sandbox's expiry by its configured TTL. The plan's session cap still applies; once it is exhausted the sandbox can no longer be renewed.

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

application/json

curl -X POST "https://example.com/sandboxes/string/renew"
{  "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"  }}

Destroy a sandbox POST

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

Resize a sandbox POST

Sets an exact allocation. A sleeping sandbox's allocation changes immediately. A running sandbox is resized live only when the provider can verify the change; otherwise the shape is stored as `pendingAllocation` and applied on the next wake.