sandboxes

Create a sandbox

post/sandboxes

Request

  • Base URL: https://api.eqvps.com/api/v1/eqvps
  • URL: https://api.eqvps.com/api/v1/eqvps/sandboxes
  • Auth: HTTP bearer

Request body

mode'ephemeral' | 'persistent'
tariff'micro' | 'small' | 'standard' | 'plus' | 'pro' | 'max'

micro 0.25 vCPU/512 MB/3 GB · small 0.5/1 GB/5 GB · standard 1/2 GB/10 GB · plus 2/4 GB/15 GB · pro 4/8 GB/20 GB · max 8/16 GB/40 GB

idle_timeoutinteger

Seconds of inactivity before an ephemeral sandbox is deleted (default 300, max 3600)

ttlinteger

Max lifetime in seconds (ephemeral ≤86400, persistent ≤2592000)

envSbxEnv

Environment variables for the process. Up to 64 names, 32 KB per value, 64 KB total. Values are stored encrypted, never returned by the API and not logged; responses show only env_keys. On create: applied to every exec/run in the sandbox. On exec/run: applied to that call and merged over the sandbox env.

Response

Created

idstring
mode'ephemeral' | 'persistent'
tariffstring
state'running' | 'starting' | 'paused' | 'pausing' | 'resuming' | 'deleting'

running = ready for commands (the internal sbxd state 'busy' is shown as running)

created_atstring date-time
expires_atstring date-time
last_activestring date-time
idle_timeoutinteger
ttlinteger
throttledboolean
paused_atstring date-time
pause_reasonstring
delete_afterstring date-time
price_usd_per_hournumber
readyboolean

true when commands can run

env_keysstring[]

Names of environment variables set on create (values are never returned)

Changes

No recorded changes to this operation across all 1 revision of this API.