API Reference · v1

REST · MCP · SDK. Stable since day one.

Versioned endpoints, machine-readable schemas, no breaking changes without a major bump. Use the REST API directly, the MCP server for tool-using agents, or the typed SDKs for TypeScript and Python.

Base URL

https://api.quellra.com/v1

Auth

Bearer tokens scoped per workspace. Rotate from the console.

Rate limits

Per-tenant token bucket. 600 req/min default · 6000 req/min on Growth+.

Versioning

Date-pinned via Quellra-Version header. Defaults to your workspace pin.

POST · /workflows/{id}/runscreate a run

curl https://api.quellra.com/v1/workflows/recover_failed_payments/runs \
  -H "Authorization: Bearer $QUELLRA_API_KEY" \
  -H "Quellra-Version: 2026-05-01" \
  -d '{ "customer_id": "cus_3PqA", "context": { "plan": "growth" } }'

// 202 Accepted
{
  "run_id":    "run_8aA…",
  "workflow":  "recover_failed_payments",
  "status":    "queued",
  "trace_url": "https://quellra.app/runs/8aA"
}

GET · /runs/{id}retrieve a run

{
  "run_id": "run_8aA",
  "status": "resolved",
  "latency_ms": 4119,
  "steps": [
    { "agent": "planner",  "output": { "severity": "medium" } },
    { "agent": "executor", "tool": "stripe.charge.retry", "ok": true },
    { "agent": "verifier", "confidence": 0.96 },
    { "agent": "writer",   "channel": "email", "sent": true }
  ]
}

GET · /workflowslist workflows

{
  "data": [
    { "id": "recover_failed_payments", "version": 14, "status": "live" },
    { "id": "integration_refresh",     "version": 8,  "status": "live" },
    { "id": "activation_nudge",        "version": 6,  "status": "live" }
  ]
}

Endpoints

Method	Path	Description
POST	/workflows/{id}/runs	Trigger a workflow run.
GET	/runs/{id}	Retrieve a single run with full trace.
GET	/runs	List runs with filters and pagination.
POST	/runs/{id}/approve	Approve a pending action.
GET	/workflows	List installed workflows.
POST	/workflows	Register a custom workflow.
GET	/tools	List registered tools and scopes.
POST	/evals/{id}/run	Run an eval set ad hoc.
GET	/audit?since=…	Stream audit log entries.
POST	/webhooks	Subscribe to event types.