DEdexto
Sandboxes

Create a sandbox

Create a named sandbox in the API key's Cloud project, not started. A name that already exists returns that sandbox with 200, so retries never create a second one; the same name with another size is a 409. The body is required.

post/v1/sandboxes

Request

  • Base URL
    https://api.dexto.ai
  • URL
    https://api.dexto.ai/v1/sandboxes
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring required

Request body

namestring required

Unique among the project's sandboxes: 1-63 lowercase letters, digits and hyphens, starting and ending with a letter or digit.

size'large' required

large is 4 vCPU and 8 GiB of memory. More sizes will follow.

Response

Returned the existing sandbox with this name.

created_atstring date-time required
idstring uuid required
namestring required
object'sandbox' required
size'small' | 'large' required
status'not_started' | 'running' | 'paused' | 'terminated' required

terminated means the workspace is gone; starting the sandbox again begins with an empty one.

updated_atstring date-time required

Changes

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