Skip to main content
POST
/
api
/
sessions
/
{session_id}
/
agent
/
task
Run Task
curl --request POST \
  --url https://agentcell.live/api/sessions/{session_id}/agent/task

​
Path parameters

ParameterTypeDescription
session_idstringThe session ID (must be in ready status)

​
Request body

FieldTypeRequiredDescription
taskstringYesPlain English instruction for the AI agent
max_stepsintegerNoMaximum actions the agent can take (1-200, default 20)
curl -X POST https://agentcell.live/api/sessions/SESSION_ID/agent/task \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"task": "Search DuckDuckGo for the weather in Tokyo"}'

​
Response

{
  "status": "completed",
  "summary": "Successfully searched DuckDuckGo for the weather in Tokyo. The current temperature is 18°C with partly cloudy skies.",
  "steps": [
    {
      "tool": "open_app",
      "args": {"package": "org.nicoco.nicobrowser"},
      "ok": true
    },
    {
      "tool": "click",
      "args": {"index": 3},
      "ok": true
    }
  ]
}

​
Response fields

FieldTypeDescription
statusstring"completed" or "failed"
summarystringHuman-readable description of what happened
stepsarrayList of actions the agent took

​
Error responses

CodeMeaning
402Trial expired — subscribe to continue
404Session not found
409Session not ready (still booting)

​
Tips

  • DuckDuckGo over Google — Google blocks cloud IPs with reCAPTCHA. Use DuckDuckGo for web searches.
  • One task at a time — each session runs one agent task at a time. Wait for completion before sending the next.
  • Fresh sessions — each session starts as a clean Android install. Apps and state don’t persist between sessions.