> ## 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.

# Sandbox quickstart

> Create, list, and remove a testing number through the public Platform API.

You need:

* A development project UUID.
* An organization key with `sessions:read` and `sessions:manage`.

Keep the credential on a trusted server.

## 1. Create a testing number

```bash theme={null}
curl -X POST "https://api.polymorfa.com/v1/sessions/testing" \
  -H "Authorization: Bearer $TITAN_ORG_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "'"$PROJECT_ID"'",
    "name": "Quickstart sender",
    "country": "US"
  }'
```

`projectId` is required. `country` is optional and defaults to `US`; accepted
values are `US`, `GB`, `BR`, and `IN`. The response contains the generated
testing-session identifier.

## 2. List the project's sessions

```bash theme={null}
curl "https://api.polymorfa.com/v1/sessions?projectId=$PROJECT_ID" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"
```

Select the row whose generated session identifier matches the create response.
Testing-number rows have `testMode: true`.

## 3. Remove the testing number

```bash theme={null}
curl -X DELETE \
  "https://api.polymorfa.com/v1/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $TITAN_ORG_KEY"
```

Removal is permanent. Use the generated Platform API endpoint pages for the
complete request, response, authorization, and error schemas.

## Where to go next

<Columns cols={2}>
  <Card title="Number pool" icon="phone" href="/sandbox/number-pool">
    List and manage testing numbers.
  </Card>

  <Card title="Claims and devices" icon="lock" href="/sandbox/claims-and-devices">
    Open a testing session in the desktop app.
  </Card>

  <Card title="Sandbox limits" icon="layer-group" href="/sandbox/tiers">
    Review throughput and included data.
  </Card>

  <Card title="Authentication" icon="key" href="/api/authentication">
    Review credential audiences and scopes.
  </Card>
</Columns>