Create Session

Spawn a new Android phone instance

POST /api/sessions

Create Session

cURL

curl --request POST \
  --url https://agentcell.live/api/sessions

Request

No body required. Send an empty JSON object:

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

Response

{
  "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.