API Overview

https://api.avala.ai/api/v1

curl https://api.avala.ai/api/v1/agents \
  -H "X-Avala-Api-Key: avk_..."

{
  "id": "agt_abc123",
  "name": "Research Agent",
  "status": "active",
  "created_at": "2025-09-15T08:30:00Z"
}

{
  "next": "https://api.avala.ai/api/v1/agents?cursor=abc123",
  "previous": null,
  "results": [
    {
      "id": "agt_abc123",
      "name": "Research Agent"
    }
  ]
}

# Paginate through all datasets
import requests

headers = {"X-Avala-Api-Key": "YOUR_API_KEY"}
url = "https://api.avala.ai/api/v1/datasets/?limit=50"

all_datasets = []
while url:
    response = requests.get(url, headers=headers)
    data = response.json()
    all_datasets.extend(data["results"])
    url = data["next"]  # None when no more pages

print(f"Total datasets: {len(all_datasets)}")

{
  "detail": "A human-readable description of the error."
}