Run Task
curl --request POST \
--url https://agentcell.live/api/sessions/{session_id}/agent/taskimport requests
url = "https://agentcell.live/api/sessions/{session_id}/agent/task"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://agentcell.live/api/sessions/{session_id}/agent/task', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://agentcell.live/api/sessions/{session_id}/agent/task",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://agentcell.live/api/sessions/{session_id}/agent/task"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://agentcell.live/api/sessions/{session_id}/agent/task")
.asString();require 'uri'
require 'net/http'
url = URI("https://agentcell.live/api/sessions/{session_id}/agent/task")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyAgent
Run Task
Run a natural language task on a session
POST
/
api
/
sessions
/
{session_id}
/
agent
/
task
Run Task
curl --request POST \
--url https://agentcell.live/api/sessions/{session_id}/agent/taskimport requests
url = "https://agentcell.live/api/sessions/{session_id}/agent/task"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://agentcell.live/api/sessions/{session_id}/agent/task', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://agentcell.live/api/sessions/{session_id}/agent/task",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://agentcell.live/api/sessions/{session_id}/agent/task"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://agentcell.live/api/sessions/{session_id}/agent/task")
.asString();require 'uri'
require 'net/http'
url = URI("https://agentcell.live/api/sessions/{session_id}/agent/task")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyPath parameters
| Parameter | Type | Description |
|---|---|---|
session_id | string | The session ID (must be in ready status) |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
task | string | Yes | Plain English instruction for the AI agent |
max_steps | integer | No | Maximum 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
| Field | Type | Description |
|---|---|---|
status | string | "completed" or "failed" |
summary | string | Human-readable description of what happened |
steps | array | List of actions the agent took |
Error responses
| Code | Meaning |
|---|---|
| 402 | Trial expired — subscribe to continue |
| 404 | Session not found |
| 409 | Session 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.
⌘I
