API Reference
Complete REST API reference for the Future AGI platform.
API Reference
The Future AGI REST API provides programmatic access to all platform features including simulations, evaluations, datasets, and more.
Base URL
https://api.futureagi.comAuthentication
All API endpoints require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYNote
Get your API key from the Future AGI Dashboard.
API Categories
Health
Health check operations for monitoring server status
Authentication
User authentication and token management
Scenarios
Test scenario management and execution
Agent Definitions
Agent definition CRUD operations
Agent Versions
Agent version control and management
Simulator Agents
Simulator agent operations
Run Tests
Test execution management
Test Executions
Test execution tracking and analytics
Call Executions
Individual call execution details
Call Transcripts
Transcript management and retrieval
Personas
Persona management for testing
Analytics
Analytics and reporting
Export Simulate
Data export operations
Datasets
Operations related to datasets, including creation, modification, and data management.
Annotation Scores
Create, read, and delete annotation scores across traces, spans, sessions, and datasets
Annotation Labels
Manage reusable annotation label templates (categorical, numeric, text, star, thumbs)
Annotation Queues
Create and manage annotation queues with assignment strategies and progress tracking
Queue Items
Add items to queues, submit annotations, complete and skip items
Bulk Annotation
Bulk annotate spans via the legacy tracer API (up to 1000 records per request)
Eval Groups
Evaluation group management
Eval Templates
Base evaluation template operations
Custom Eval Templates
Custom evaluation template CRUD operations
Eval Playground
Test and run evaluations in playground environment
Eval Logs & Metrics
Evaluation logs, metrics, and execution tracking
Eval Configuration
Evaluation configuration and templates retrieval
API Keys
API key management
Rate Limits
- Standard tier: 100 requests per minute
- Pro tier: 1000 requests per minute
- Enterprise: Custom limits
Rate limit headers are included in all responses:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699900000Error Handling
All errors return a consistent JSON structure:
{
"error": {
"code": "error_code",
"message": "Human readable error message",
"details": {}
}
}Common Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Resource doesn’t exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error |