Base URL and authentication
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:writecan 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/meworks with any key.
/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)
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
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.