Documentation de l'API

export KEY=bb_live_…

# 1. Un agent (son ordinateur s'allumera à sa première tâche)
curl https://api.baguettebot.com/v1/agents -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name": "Veille prix", "instructions": "Réponds en français, avec un tableau."}'

# 2. Une tâche, et la réponse quand c'est fini (jusqu'à 120 s)
curl https://api.baguettebot.com/v1/agents/AGENT_ID/messages -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"content": "Compare le prix de la PS5 sur Amazon, la Fnac et Boulanger", "wait": true}'

Authorization: Bearer bb_live_…

{
  "id": "6f1c2a8e-…",
  "object": "agent",
  "name": "Shopping assistant",
  "model": "anthropic/claude-haiku-5.5",
  "instructions": "…",
  "status": "idle",            // idle | working | blocked
  "status_text": null,
  "computer": { "status": "stopped" },
  "idle_minutes": 5,
  "metadata": { "customer_id": "c_42" },
  "created_at": "2026-10-22T09:12:03.000Z"
}

{
  "object": "run",
  "agent_id": "6f1c2a8e-…",
  "message_id": "b2e0…",
  "status": "done",            // done | working (still running after 120 s)
  "output": "| Shop | Price |\n|---|---|\n| … |",
  "messages": [
    { "id": "…", "role": "assistant", "content": null, "tool_calls": [{ "name": "browser", "summary": "…" }], "created_at": "…" },
    { "id": "…", "role": "tool", "content": "…", "tool": { "name": "browser", "ok": true, "summary": "…" }, "created_at": "…" },
    { "id": "…", "role": "assistant", "content": "| Shop | Price | …", "created_at": "…" }
  ]
}

event: ready
data: {"agent_id":"6f1c2a8e-…"}

event: status
data: {"status":"working","text":"…"}

event: delta
data: {"message_id":"…","text":"The cheapest"}

event: message
data: {"id":"…","role":"tool","content":"…","tool":{"name":"browser","ok":true,"summary":"…"},"created_at":"…"}

event: computer
data: {"status":"running"}

const res = await fetch("https://api.baguettebot.com/v1/agents/" + agentId + "/events", {
  headers: { Authorization: "Bearer " + process.env.BAGUETTE_API_KEY },
});
const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
let buffer = "";
for (;;) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += value;
  let i;
  while ((i = buffer.indexOf("\n\n")) !== -1) {
    const chunk = buffer.slice(0, i); buffer = buffer.slice(i + 2);
    const type = /^event: (.+)$/m.exec(chunk)?.[1];
    const data = /^data: (.+)$/m.exec(chunk)?.[1];
    if (type && data) console.log(type, JSON.parse(data));
  }
}

{ "object": "live_view", "url": "https://api.baguettebot.com/v1/live/…", "interactive": false, "expires_at": "2026-10-22T10:12:03.000Z" }

<iframe src="LIVE_URL"
  style="width:100%;aspect-ratio:16/10;border:0;border-radius:12px"></iframe>

{ "error": { "code": "insufficient_balance", "message": "…" } }

// Node 18+
const KEY = process.env.BAGUETTE_API_KEY;
const api = (path, body, method = body ? "POST" : "GET") =>
  fetch("https://api.baguettebot.com" + path, {
    method,
    headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
    body: body && JSON.stringify(body),
  }).then(async (r) => {
    if (!r.ok) throw new Error((await r.json()).error?.message ?? r.statusText);
    return r.json();
  });

const agent = await api("/v1/agents", { name: "Assistant", model: "anthropic/claude-haiku-5.5" });
const run = await api(`/v1/agents/${agent.id}/messages`, { content: "…", wait: true });
console.log(run.output);

import os, requests

API = "https://api.baguettebot.com"
H = {"Authorization": f"Bearer {os.environ['BAGUETTE_API_KEY']}"}

agent = requests.post(f"{API}/v1/agents", headers=H, json={"name": "Assistant"}).json()
run = requests.post(f"{API}/v1/agents/{agent['id']}/messages", headers=H,
                    json={"content": "…", "wait": True}, timeout=150).json()
print(run["output"])