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

# What is Sandbox?

> Create and manage simulated testing numbers without connecting a real WhatsApp number.

Polymorfa Sandbox provides testing numbers for development projects. Testing
numbers have `testMode` enabled and do not connect to real WhatsApp recipients.

Use Sandbox to verify number-management and signed-in desktop workflows before
you register a production number. The current public API supports creating and
managing testing sessions. It does not publish Sandbox message send or history
endpoints.

## Available workflows

| Workflow                 | Route                                    | Credential                           |
| ------------------------ | ---------------------------------------- | ------------------------------------ |
| Create a testing number  | `POST /v1/sessions/testing`              | Organization key or dashboard bearer |
| List project sessions    | `GET /v1/sessions?projectId={projectId}` | Organization key or dashboard bearer |
| Stop a testing session   | `POST /v1/sessions/{sessionId}/stop`     | Organization key or dashboard bearer |
| Remove a testing session | `DELETE /v1/sessions/{sessionId}`        | Organization key or dashboard bearer |
| Open a testing session   | Polymorfa Inspector                      | Signed-in Inspector session          |

The create request requires a development-project UUID. It can also include a
display name and a country code of `US`, `GB`, `BR`, or `IN`. List the project
sessions and select rows with `testMode: true` instead of assuming a fixed
number count or phone format.

## Limits and billing

Sandbox testing numbers use the Free number tier:

* 0 credits per online session-day.
* 5 messages per second per testing number.
* 0.25 GB of included data per testing number.
* No real-number registration, campaigns, outbound-call allowance, or
  serverless-call allowance.

These are number-tier limits. Your organization's Basic, Premium, or Enterprise
team plan is a separate choice.

## Desktop claims

In Inspector, choose **Open** beside a testing number. Inspector claims the
number for your device and opens the session. Choose **Release** to close the
session and make the number available again.

## Where to go next

<Columns cols={2}>
  <Card title="Sandbox quickstart" icon="bolt" href="/sandbox/quickstart">
    Create, list, and remove a testing number.
  </Card>

  <Card title="Number pool" icon="phone" href="/sandbox/number-pool">
    Manage testing numbers through the public Platform API.
  </Card>

  <Card title="Sandbox limits" icon="layer-group" href="/sandbox/tiers">
    Review the current Free number-tier limits.
  </Card>

  <Card title="Claims and devices" icon="lock" href="/sandbox/claims-and-devices">
    Open a testing session from a signed-in desktop device.
  </Card>
</Columns>