Skip to main content

Base URL and authentication

Send Authorization: Bearer <token> with every request. The token is either a sign-in JWT or an API key (fib_…, created in the web app under Dashboard → Developer access, or with POST /api-keys). API keys carry scopes, such as workflows:execute or agents:authorize; GET /api-keys/scopes lists them. An API key can only do what its scopes say: every endpoint names the scope it needs, and a key without it gets 403 API key missing required scope: …. The first four rows are the standard set a new key gets by default. The account scopes (secrets, api_keys, organizations) are opt-in.
  • A key can’t make itself bigger. A key with api_keys:write can only create, change, revoke or reactivate keys no broader than itself, and a key it creates expires no later than it does. Signed in, you can create any key.
  • Account security needs you signed in: changing your password, MFA, logout and the developer shell refuse API keys, whatever their scopes. GET /auth/me works with any key.
Interactive docs for a self-hosted API are at /docs.

Responses and errors

Successful responses are the resource itself as JSON. Errors use FastAPI’s shape:
Rate limits are per client: 300 requests a minute by default, 10 a minute on login and 5 an hour on registration.

Run a workflow

1

Generate it from a sentence (optional)

The response has the workflow, any validation_errors, the required_inputs (e.g. xyz_email) and required_secrets (e.g. GITHUB_TOKEN), and an estimated_cost.
2

Execute it

Returns 202 Accepted with the run. status is pending (queued for a worker), or paused with approval_required: true and an approval_request_id when governance holds it first. A run that a rule would definitely deny is refused with 403; detail.blocking names each step, the rule and the labels involved.
3

Follow it

GET /runs/{run_id} for logs and node results, or stream the timeline as Server-Sent Events from GET /runs/{run_id}/events. GET /runs/{run_id}/authorization is the receipt: every tool call, its labels and the rule that decided it.

Endpoints

All paths below are under /api/v1.

Workflows

Runs

Approvals

Governance

See Governance.

External agents

See External agents.

Connections and secrets

See Connect your tools.

Tools

Versions and registry

Organizations, keys and sign-in

Skills, memory, analytics, jobs

Health (no auth)

GET /health, GET /health/db, GET /health/secrets (at the root, not under /api/v1).

SDKs

The Python SDK wraps these endpoints: pip install fibonacci-sdk. See the SDK reference.