Skip to main content
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

MethodEndpointDescription
GET/workflowsList all workflows
POST/workflowsCreate a workflow
GET/workflows/{id}Get workflow details
PUT/workflows/{id}Update a workflow
DELETE/workflows/{id}Delete a workflow

​
Execution

MethodEndpointDescription
POST/workflows/{id}/executeExecute a workflow
GET/executions/{id}Get execution status
GET/executionsList executions
POST/executions/{id}/cancelCancel execution

​
Workflow Versions

MethodEndpointDescription
GET/workflows/{id}/versionsList all versions
GET/workflows/{id}/versions/{version}Inspect a specific version
POST/workflows/{id}/versions/{version}/rollbackRoll back (creates a new snapshot)

​
Workflow Registry

MethodEndpointDescription
POST/workflow-registry/{id}/approve-templateApprove a workflow as an org template
POST/workflow-registry/{id}/deprecateMark a template as deprecated
POST/workflow-registry/{id}/archiveArchive a template
GET/workflow-registryList registry entries (hides archived by default)
Pass ?include_archived=true to /workflow-registry to include archived entries in the response.

​
Organizations — Governance

MethodEndpointDescription
GET/organizations/{id}/governanceGet governance settings
PATCH/organizations/{id}/governanceUpdate governance settings
GET/organizations/{id}/governance/reportGovernance summary dashboard
GET/organizations/{id}/governance/auditPaginated governance audit log
GET/organizations/{id}/governance/approvalsApproval statistics

​
Organizations — Quotas

MethodEndpointDescription
GET/organizations/{id}/quotaGet quota limits (plan + overrides)
PATCH/organizations/{id}/quotaSet quota overrides (owner role required)

​
Organizations — Tool Policies

MethodEndpointDescription
GET/organizations/{id}/tool-policiesList org-level tool policies
POST/organizations/{id}/tool-policiesCreate 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-overridesList role-level overrides
POST/organizations/{id}/role-policy-overridesCreate a role override

​
Memory

MethodEndpointDescription
GET/memory/{key}Get memory value
PUT/memory/{key}Set memory value
DELETE/memory/{key}Delete memory value

​
Tools

MethodEndpointDescription
GET/toolsList available tools
GET/tools/{name}Get tool details
POST/tools/{name}/connectConnect a tool

​
Health

MethodEndpointDescription
GET/healthService health check
GET/health/secretsSecrets 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

PlanRequests/minuteRequests/day
Free601,000
Pro30050,000
EnterpriseCustomCustom
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.