API Reference - Fibonacci

The Fibonacci REST API allows you to programmatically manage workflows, execute them, and interact with the Fibonacci platform.

Base URL

https://api.fibonacci.dev/v1

Authentication

All API requests require authentication via API key:

curl https://api.fibonacci.dev/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY"

Get your API key from the Fibonacci Dashboard.

Quick Reference

Workflows

Method	Endpoint	Description
`GET`	`/workflows`	List all workflows
`POST`	`/workflows`	Create a workflow
`GET`	`/workflows/{id}`	Get workflow details
`PUT`	`/workflows/{id}`	Update a workflow
`DELETE`	`/workflows/{id}`	Delete a workflow

Execution

Method	Endpoint	Description
`POST`	`/workflows/{id}/execute`	Execute a workflow
`GET`	`/executions/{id}`	Get execution status
`GET`	`/executions`	List executions
`POST`	`/executions/{id}/cancel`	Cancel execution

Workflow Versions

Method	Endpoint	Description
`GET`	`/workflows/{id}/versions`	List all versions
`GET`	`/workflows/{id}/versions/{version}`	Inspect a specific version
`POST`	`/workflows/{id}/versions/{version}/rollback`	Roll back (creates a new snapshot)

Workflow Registry

Method	Endpoint	Description
`POST`	`/workflow-registry/{id}/approve-template`	Approve a workflow as an org template
`POST`	`/workflow-registry/{id}/deprecate`	Mark a template as deprecated
`POST`	`/workflow-registry/{id}/archive`	Archive a template
`GET`	`/workflow-registry`	List registry entries (hides archived by default)

Pass ?include_archived=true to /workflow-registry to include archived entries in the response.

Organizations — Governance

Method	Endpoint	Description
`GET`	`/organizations/{id}/governance`	Get governance settings
`PATCH`	`/organizations/{id}/governance`	Update governance settings
`GET`	`/organizations/{id}/governance/report`	Governance summary dashboard
`GET`	`/organizations/{id}/governance/audit`	Paginated governance audit log
`GET`	`/organizations/{id}/governance/approvals`	Approval statistics

Organizations — Quotas

Method	Endpoint	Description
`GET`	`/organizations/{id}/quota`	Get quota limits (plan + overrides)
`PATCH`	`/organizations/{id}/quota`	Set quota overrides (owner role required)

Organizations — Tool Policies

Method	Endpoint	Description
`GET`	`/organizations/{id}/tool-policies`	List org-level tool policies
`POST`	`/organizations/{id}/tool-policies`	Create a tool policy
`PATCH`	`/organizations/{id}/tool-policies/{tool}`	Update a tool policy
`DELETE`	`/organizations/{id}/tool-policies/{tool}`	Delete a tool policy
`GET`	`/organizations/{id}/role-policy-overrides`	List role-level overrides
`POST`	`/organizations/{id}/role-policy-overrides`	Create a role override

Memory

Method	Endpoint	Description
`GET`	`/memory/{key}`	Get memory value
`PUT`	`/memory/{key}`	Set memory value
`DELETE`	`/memory/{key}`	Delete memory value

Tools

Method	Endpoint	Description
`GET`	`/tools`	List available tools
`GET`	`/tools/{name}`	Get tool details
`POST`	`/tools/{name}/connect`	Connect a tool

Health

Method	Endpoint	Description
`GET`	`/health`	Service health check
`GET`	`/health/secrets`	Secrets backend connectivity check

Request Format

All requests should include:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Response Format

Successful responses return JSON:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123"
  }
}

Error responses:

{
  "error": {
    "code": "validation_error",
    "message": "Invalid input",
    "details": [...]
  }
}

Rate Limits

Plan	Requests/minute	Requests/day
Free	60	1,000
Pro	300	50,000
Enterprise	Custom	Custom

Rate limit headers are included in responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1706054400

SDKs

We recommend using our official SDKs:

Python: pip install fibonacci-sdk
Node.js: npm install @fibonacci/sdk (coming soon)

Example: Execute a Workflow

curl -X POST https://api.fibonacci.dev/v1/workflows/wf-abc123/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "text": "Analyze this text"
    }
  }'

Response:

{
  "data": {
    "execution_id": "exec_abc123",
    "status": "completed",
    "outputs": {
      "analyzer": "The text sentiment is positive..."
    },
    "duration_ms": 1523,
    "nodes_executed": 3,
    "nodes_failed": 0
  }
}

Example: Check Secrets Backend Health

curl https://api.fibonacci.dev/v1/health/secrets \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "status": "healthy",
  "backend": "aws_secrets_manager",
  "checks": {
    "list_secrets": "ok",
    "get_secret": "ok"
  }
}

See the Security guide for IAM requirements and the Governance guide for org-level policy endpoints.

​Base URL

​Authentication

​Quick Reference

​Workflows

​Execution

​Workflow Versions

​Workflow Registry

​Organizations — Governance

​Organizations — Quotas

​Organizations — Tool Policies

​Memory

​Tools

​Health

​Request Format

​Response Format

​Rate Limits

​SDKs

​Example: Execute a Workflow

​Example: Check Secrets Backend Health

Base URL

Authentication

Quick Reference

Workflows

Execution

Workflow Versions

Workflow Registry

Organizations — Governance

Organizations — Quotas

Organizations — Tool Policies

Memory

Tools

Health

Request Format

Response Format

Rate Limits

SDKs

Example: Execute a Workflow

Example: Check Secrets Backend Health