API Reference

Autonoma API

Powerful APIs to integrate autonomous software development into your workflow

API Overview

Agent Tasks

Submit development tasks to AI agents. Autonoma assigns the right agents based on your capabilities (BUILD, OPERATE, SECURE, PLATFORM).

Orchestration

Real-time visibility into agent coordination. Monitor which agents are working on your tasks and their progress.

RIGOR Framework

Invoke the 5-phase RIGOR execution framework (Research, Inspect, Generate, Optimize, Review) on any agent.

Customer Workflows

Create and manage custom workflows that chain agents together for complex operations.

Authentication

All API requests require authentication using your API key. Include your key in the Authorization header:

curl -X GET https://api.theautonoma.io/v1/health \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API Key Security

Keep your API keys secure. Never expose them in client-side code or public repositories. Use environment variables and secure key management practices.

Core Endpoints

Base URL: https://api.theautonoma.io

Agent Tasks

POST/v1/agents/tasks

Submit a development task to AI agents

Request Body:

{
  "task": "Add user authentication to React app",
  "capabilities": ["BUILD"],
  "intelligence": "core",
  "priority": "normal",
  "source": "/path/to/your/project",
  "callbackUrl": "https://your-domain.com/webhook"
}

Parameters:

task (required) - Description of the development task
capabilities (required) - Array: BUILD, OPERATE, SECURE, PLATFORM, EVOLVE, OPTIMIZE, or GOVERN
intelligence - core (default), pro, or ultra
scope - RIGOR quality level: demo, poc, mvp (default), product, or production
priority - low, normal (default), or high
source - Path to project or repository URL (optional)
callbackUrl - Webhook URL for completion notification (optional)

Response (202 Accepted):

{
  "taskId": "task_a1b2c3d4e5f6",
  "status": "queued",
  "estimatedCompletion": "2026-02-23T15:30:00Z",
  "agentsAssigned": ["req-ai", "planner-ai", "architect-ai"],
  "statusUrl": "/v1/agents/tasks/task_a1b2c3d4e5f6"
}

GET/v1/agents/tasks/{taskId}

Check the status and progress of a submitted task

Response:

{
  "taskId": "task_a1b2c3d4e5f6",
  "status": "in_progress",
  "progress": 65,
  "currentAgent": "coder-ai",
  "completedPhases": ["requirements", "architecture", "implementation"],
  "estimatedCompletion": "2026-02-23T15:30:00Z",
  "output": null,
  "error": null,
  "createdAt": "2026-02-23T15:00:00Z",
  "startedAt": "2026-02-23T15:00:05Z",
  "completedAt": null
}

Agent Management

GET/v1/agents/list

List all available AI agents and their current status

GET/v1/agents/{id}/status

Get the health and status of a specific agent

GET/v1/agents/orchestrator/coordination

Get real-time orchestration status showing all active agents coordinating on your tasks

Workflows

Workflows run a capability through the full RIGOR cycle. Every workflow request requires a scope; agents reject requests without one.

POST/api/workflows/invoke

Invoke a workflow for one of your subscribed capabilities. Returns 202 with a workflowId and statusUrl.

Request Body:

{
  "capability": "BUILD",
  "workflow": "generate-tests",
  "input": {
    "prompt": "Generate unit tests for the auth module",
    "scope": "mvp",
    "context": {},
    "options": {}
  },
  "priority": "normal",
  "timeout": 60000,
  "callbackUrl": "https://example.com/hooks/autonoma"
}

Parameters:

capability (required) - BUILD, OPERATE, SECURE, PLATFORM, EVOLVE, OPTIMIZE, or GOVERN; must be included in your subscription
workflow (required) - Name of the workflow to run
input.prompt (required) - What you want done
input.scope (required) - RIGOR quality level: demo, poc, mvp, product, or production
input.context, input.options - Optional objects passed through to the workflow
priority - low, normal (default), or high
timeout - Milliseconds, up to 300000 (default 60000)
callbackUrl - Webhook URL called when the workflow completes (optional)

GET/api/workflows/{workflowId}/status

Get the status, per-phase progress and output of a workflow. Poll this until the status is terminal, or supply callbackUrl on invoke.

GET/api/workflows

List your workflow executions

POST/api/workflows/cancel/{workflowId}

Cancel a running workflow

Customer Workflows

POST/v1/customer/workflow

Execute a custom workflow that chains multiple agents together

GET/v1/customer/workflow/{id}

Get workflow details and results

GET/v1/customer/workflow/{id}/status

Check the execution status of a workflow

Utility

GET/v1/health

API health check - verify connectivity and service status

GET/v1/info

Get API version, available endpoints, and documentation links

Rate Limits

API rate limits vary by plan. Rate limit information is included in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1642550400

Plan	Requests/Hour	Burst Limit
Startup	1,000	17/min
Growth	2,500	42/min
Scale	5,000	84/min
Enterprise	10,000+	167/min

Autonoma API

API Overview

Agent Tasks

Orchestration

RIGOR Framework

Customer Workflows

Authentication

Core Endpoints

Agent Tasks

Agent Management

Workflows

Customer Workflows

Utility

Rate Limits

Resources

Getting Started

SDK Libraries

Code Examples