Skip to main content
POST
Create a SandboxTemplate

Body

application/json

Request model for creating a SandboxTemplate.

Users can only configure the container image, resource limits, and volume mounts. All other pod spec details are filled in with secure defaults.

name
string
required

Name of the template (max 63 chars, DNS-1035 format: lowercase alphanumeric and hyphens, must start with letter)

image
string
required

Container image to use for the sandbox

Examples:

"python:3.12-slim"

"node:20-slim"

resources
ResourceSpec · object

Resource limits for the sandbox

volume_mounts
VolumeMountSpec · object[]

Optional list of volumes to mount in the sandbox

Response

Successful Response

Response model for a SandboxTemplate.

name
string
required
image
string
required
resources
ResourceSpec · object
required

Resource specification for a sandbox.

id
string<uuid> | null

Unique template identifier

volume_mounts
VolumeMountSpec · object

Specification for mounting a volume in a sandbox template.

created_at
string | null
updated_at
string | null