---
title: "Create a Sandbox Compute pool"
method: POST
path: "/sandbox"
tags: ["Sandbox"]
---

# Create a Sandbox Compute pool

`POST /sandbox`

## Request body

- union
  - object
    - `tier` 'small' | 'medium'
    - `name` string
    - `callback_url` string, uri
    - `models` string[], required
    - `model_categories` string[]
  - object
    - `tier` 'small' | 'medium'
    - `name` string
    - `callback_url` string, uri
    - `models` string[]
    - `model_categories` string[], required

## Response `200`

Sandbox accepted for provisioning

- SandboxResponse
  - `success` boolean
  - `data` Sandbox
    - `sandbox_id` string
    - `name` string
    - `tier` 'small' | 'medium'
    - `status` 'provisioning' | 'active' | 'alert' | 'stopping' | 'stopped' | 'failed'
    - `models` string[]
    - `model_categories` string[]
    - `region` string
    - `expires_at` string, date-time
    - `created_at` string, date-time
    - `started_at` string, date-time
    - `stopped_at` string, date-time

---

[API](https://skmtc.net/video-db/apis/videodb-server-api.md) · [All operations](https://skmtc.net/video-db/apis/videodb-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/video-db/videodb-server-api/revisions/21b1d1d3eae8/schema)