Skip to main content
Every endpoint below is generated from the OpenAPI specification the API serves at /openapi.json, so it matches the running build rather than a hand-written table. A local stack also exposes an interactive copy at http://localhost:8000/docs.

​
Base URL

All platform endpoints are under /v1.

​
Authentication

Send a bearer token on every /v1 request:
Requests without a valid token are rejected with 401. There is no anonymous read access to /v1, including on endpoints that look public.

​
Workspace scoping

A token resolves to a user and a workspace. Every list endpoint returns only what that workspace can see, and every write lands in it — there is no global scope and no cross-workspace query. See workspaces, projects, and resources for the model this enforces.

​
Errors

Failures return a JSON body with a machine-readable code. The meanings, and which ones are safe to retry, are in errors.

Start a task

The most common first call, end to end.

Errors

What each failure code means.

Limits

Budgets, quotas, and the ceilings requests are checked against.

Authorization model

The relations behind every permission check.
Last modified on September 17, 2026