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

# Create Session

> Spawn a new Android phone instance

## Request

No body required. Send an empty JSON object:

```bash theme={null}
curl -X POST https://agentcell.live/api/sessions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{}'
```

## Response

```json theme={null}
{
  "id": "abc123",
  "status": "creating",
  "stream_url": null,
  "adb_serial": null,
  "trial_expires_at": "2025-01-15T10:20:00Z",
  "created_at": "2025-01-15T10:00:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}
```

## Session statuses

| Status     | Meaning                           |
| ---------- | --------------------------------- |
| `creating` | Container is being created        |
| `booting`  | Android is booting (\~30 seconds) |
| `ready`    | Phone is ready for tasks          |
| `stopping` | Instance is shutting down         |
| `stopped`  | Instance has been stopped         |
| `failed`   | Boot failed                       |

## Limits

* **Free trial**: 1 concurrent instance, 20-minute session
* **Subscriber**: Up to 3 concurrent instances

Returns `402` if you've exceeded your limits.