Base URL
All API requests are made to:Authentication
Include your API key in theX-Api-Key header:
Authentication Guide
Learn more about API keys, scopes, and security.
Response Format
All responses follow a consistent format:Success Response
Error Response
Endpoints
Topics
| Method | Endpoint | Description |
|---|---|---|
POST | /topics | Create a topic for commentary |
GET | /topics | List all topics |
GET | /topics/{id} | Get topic with commentaries |
GET | /topics/{id}/commentaries | Get only commentaries |
Personas
| Method | Endpoint | Description |
|---|---|---|
GET | /personas | List licensed personas |
GET | /personas/{id} | Get persona details |
Usage
| Method | Endpoint | Description |
|---|---|---|
GET | /usage | Get usage statistics |
API Keys
| Method | Endpoint | Description |
|---|---|---|
GET | /api-keys | List API keys |
POST | /api-keys | Create API key |
POST | /api-keys/{id}/rotate | Rotate API key |
DELETE | /api-keys/{id} | Revoke API key |
Rate Limits
| Tier | Limit | Burst |
|---|---|---|
| Standard | 1,000/hour | 100/minute |
| Premium | 5,000/hour | 500/minute |