> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a sandbox

> Creates an isolated test workspace for your live Plane workspace.

### Parameters

<ParamField body="name" type="string" required>
  Human-readable name for the sandbox.
</ParamField>

### Returns

Returns the created [Sandbox](/reference/sandboxes-object). New sandboxes are
typically returned with a `provisioning` status before the test workspace is
fully ready.

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
  }
  ```
</ResponseExample>