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
/v1/agents/tasksSubmit 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 taskcapabilities(required) - Array:BUILD,OPERATE,SECURE,PLATFORM,EVOLVE,OPTIMIZE, orGOVERNintelligence-core(default),pro, orultrascope- RIGOR quality level:demo,poc,mvp(default),product, orproductionpriority-low,normal(default), orhighsource- 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"
}/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
/v1/agents/listList all available AI agents and their current status
/v1/agents/{id}/statusGet the health and status of a specific agent
/v1/agents/orchestrator/coordinationGet real-time orchestration status showing all active agents coordinating on your tasks
RIGOR Framework
/v1/admin/rigor/invoke/{personality}Invoke the RIGOR framework on a specific agent (e.g., coder-ai, architect-ai)
Request Body:
{
"prompt": "Generate unit tests for auth module",
"priority": "normal",
"acmfMode": "ASSISTED"
}/v1/admin/rigor/status/{executionId}Get the status and result of a RIGOR execution
/v1/admin/rigor/healthCheck the health of the RIGOR framework
Customer Workflows
/v1/customer/workflowExecute a custom workflow that chains multiple agents together
/v1/customer/workflow/{id}Get workflow details and results
/v1/customer/workflow/{id}/statusCheck the execution status of a workflow
Utility
/v1/healthAPI health check - verify connectivity and service status
/v1/infoGet 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 |