REST API

The REST API lets your systems create agents and submit operations directly.

Base URL

https://anysola.com/api

All requests and responses are JSON. Authenticate with a workspace API key — see Authentication.

Typical flow

# 1. List your deployed agents
curl https://anysola.com/api/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

# 2. Submit an operation to an agent
curl -X POST https://anysola.com/api/agents/AGENT_ID/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "DOCUMENT_REVIEW",
    "detail": "contract-2024-118.pdf",
    "status": "ok",
    "durationMs": 1840
  }'

Error handling

The API uses conventional status codes: 400 validation error, 401 missing/invalid key, 402 plan limit reached, 404 not found, 429 rate limited. Error bodies always have the shape {"error": "human-readable message"}.

Retry 429 and 5xx responses with exponential backoff; respect the Retry-After header on 429.