Skip to main content
POST
/
v1
/
sandboxes
Create a sandbox
curl --request POST \
  --url https://api.plane.com/v1/sandboxes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
{
  "id": "sbx_3vNqM7xRk2pWsT",
  "name": "API Sandbox",
  "status": "provisioning",
  "workspace": "wsp_4kW3GnQCo1CQ49",
  "sandbox_workspace": "wsp_test_9nD31mQzRa8kF2",
  "created": "2026-03-28T17:20:00Z",
  "updated": "2026-03-28T17:20:00Z"
}

​
Parameters

​
name
string
required
Human-readable name for the sandbox.

​
Returns

Returns the created Sandbox. New sandboxes are typically returned with a provisioning status before the test workspace is fully ready. 
{
  "id": "sbx_3vNqM7xRk2pWsT",
  "name": "API Sandbox",
  "status": "provisioning",
  "workspace": "wsp_4kW3GnQCo1CQ49",
  "sandbox_workspace": "wsp_test_9nD31mQzRa8kF2",
  "created": "2026-03-28T17:20:00Z",
  "updated": "2026-03-28T17:20:00Z"
}