API Reference

This section contains the complete API reference for the Aragora platform.

Base URL

https://api.aragora.ai/api/v1

For self-hosted deployments, replace with your server URL. Legacy /api/... paths are also supported for backward compatibility.

Authentication

All API requests require authentication via Bearer token:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.aragora.ai/api/v1/debates

See the Authentication Guide for details on obtaining API keys.

API Sections

Core APIs

Section	Description
Debates	Create, manage, and query debates
Agents	Agent configuration and management
Knowledge	Knowledge Mound operations
Workflows	Automated workflow execution
Control Plane	Orchestrate agents, tasks, and deliberations
Decisions	Unified decision routing (full generated reference)

Full Reference

For the complete endpoint list, see the generated API docs:

• API Reference (generated)
• API Endpoints (generated)
• OpenAPI JSON

Rate Limits

Tier	Requests/min	Debates/hour
Free	60	10
Pro	300	100
Enterprise	Custom	Custom

Rate limit headers are included in all responses:

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

Error Handling

All errors follow a consistent format:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please retry after 60 seconds.",
    "details": {
      "retry_after": 60
    }
  }
}

Common Error Codes

Code	HTTP Status	Description
UNAUTHORIZED	401	Invalid or missing API key
FORBIDDEN	403	Insufficient permissions
NOT_FOUND	404	Resource not found
RATE_LIMIT_EXCEEDED	429	Too many requests
INTERNAL_ERROR	500	Server error

SDKs

Official SDKs are available for:

• TypeScript/JavaScript
• Python

OpenAPI Specification

The complete OpenAPI specification is available at:

https://api.aragora.ai/api/v1/openapi.json

You can import this into tools like Postman or use it to generate clients.