Quickstart

curl -sS -X POST "https://api.autumn.ai/task" \
  -H "X-API-Key: $AUTUMN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "List the top 20 posts on Hacker News today with their points",
    "clarify": false
  }'

import os, requests

AUTUMN = "https://api.autumn.ai"
HEADERS = {"X-API-Key": os.environ["AUTUMN_API_KEY"]}

task = requests.post(
    f"{AUTUMN}/task",
    headers=HEADERS,
    json={"prompt": "List the top 20 posts on Hacker News today with their points",
          "clarify": False},
).json()

task_id = task["task_id"]

const AUTUMN = "https://api.autumn.ai";
const HEADERS = {
  "X-API-Key": process.env.AUTUMN_API_KEY,
  "Content-Type": "application/json",
};

const res = await fetch(`${AUTUMN}/task`, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    prompt: "List the top 20 posts on Hacker News today with their points",
    clarify: false,
  }),
});
const { task_id } = await res.json();

import time

ACTIVE_STATUSES = {"execute", "running"}
ACTIVE_ACTIVITIES = {"executing", "running", "planning", "thinking"}

def is_terminal(task):
    if task.get("status") == "deleted" or task.get("activity") == "deleted":
        return True
    if task.get("error") in {"out_of_credits", "error"}:
        return True
    return not (task.get("phase") == "execute"
                or task.get("status") in ACTIVE_STATUSES
                or task.get("activity") in ACTIVE_ACTIVITIES)

while True:
    task = requests.get(f"{AUTUMN}/task/{task_id}", headers=HEADERS).json()
    if is_terminal(task):
        break
    time.sleep(2)

const ACTIVE_STATUSES = new Set(["execute", "running"]);
const ACTIVE_ACTIVITIES = new Set(["executing", "running", "planning", "thinking"]);

const isTerminal = (t) =>
  t.status === "deleted" || t.activity === "deleted" ||
  ["out_of_credits", "error"].includes(t.error) ||
  !(t.phase === "execute" ||
    ACTIVE_STATUSES.has(t.status) ||
    ACTIVE_ACTIVITIES.has(t.activity));

let task;
do {
  await new Promise((r) => setTimeout(r, 2000));
  task = await fetch(`${AUTUMN}/task/${task_id}`, { headers: HEADERS }).then((r) => r.json());
} while (!isTerminal(task));

# poll every 2s until status=plan and activity=idle
while :; do
  curl -sS "https://api.autumn.ai/task/$TASK_ID" -H "X-API-Key: $AUTUMN_API_KEY"
  sleep 2
done

curl -sS "https://api.autumn.ai/task/$TASK_ID/output?limit=100" \
  -H "X-API-Key: $AUTUMN_API_KEY"

rows = requests.get(
    f"{AUTUMN}/task/{task_id}/output",
    headers=HEADERS,
    params={"limit": 100},
).json()["rows"]

for row in rows:
    print({k: v["value"] for k, v in row.items() if isinstance(v, dict) and "value" in v})

const { rows } = await fetch(
  `${AUTUMN}/task/${task_id}/output?limit=100`,
  { headers: HEADERS },
).then((r) => r.json());