Quick Start

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

import requests

API = "https://agentcell.live/api"
KEY = "YOUR_API_KEY"
H = {"X-API-Key": KEY, "Content-Type": "application/json"}

session = requests.post(f"{API}/sessions", headers=H, json={}).json()
print(f"Session {session['id']} — {session['status']}")

const API = "https://agentcell.live/api";
const KEY = "YOUR_API_KEY";

const res = await fetch(`${API}/sessions`, {
  method: "POST",
  headers: { "X-API-Key": KEY, "Content-Type": "application/json" },
  body: "{}",
});
const session = await res.json();
console.log(`Session ${session.id} — ${session.status}`);

curl https://agentcell.live/api/sessions/SESSION_ID \
  -H "X-API-Key: YOUR_API_KEY"

import time

while True:
    s = requests.get(f"{API}/sessions/{session['id']}", headers=H).json()
    if s["status"] == "ready":
        break
    if s["status"] == "failed":
        raise Exception(s.get("error_message", "boot failed"))
    time.sleep(2)

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": "Open Settings and turn on Wi-Fi"}'

result = requests.post(
    f"{API}/sessions/{session['id']}/agent/task",
    headers=H,
    json={"task": "Open Settings and turn on Wi-Fi"},
).json()

print(result["status"])   # "completed" or "failed"
print(result["summary"])  # what the agent did

const result = await fetch(
  `${API}/sessions/${session.id}/agent/task`,
  {
    method: "POST",
    headers: { "X-API-Key": KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ task: "Open Settings and turn on Wi-Fi" }),
  },
).then(r => r.json());

console.log(result.status, result.summary);

curl -X DELETE https://agentcell.live/api/sessions/SESSION_ID \
  -H "X-API-Key: YOUR_API_KEY"

requests.delete(f"{API}/sessions/{session['id']}", headers=H)