Skip to main content
POST
/
api
/
sessions
Create Session
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

StatusMeaning
creatingContainer is being created
bootingAndroid is booting (~30 seconds)
readyPhone is ready for tasks
stoppingInstance is shutting down
stoppedInstance has been stopped
failedBoot failed

​
Limits

  • Free trial: 1 concurrent instance, 20-minute session
  • Subscriber: Up to 3 concurrent instances
Returns 402 if you’ve exceeded your limits.