API Reference
This section documents the main backend API surfaces used by the platform and frontend.
The reference is organized by domain so teams can quickly find the relevant endpoint families.
Routes are sourced from backend service modules under Core/api*.py in this repository.
API Domains
- Authentication
- Projects and Workflows
- Datasources and Buckets
- Environments
- Models and Training
- Logs and Monitoring
- Agents and Agent Tools
Base Conventions
- Base path: /api
- Content type: application/json unless noted otherwise
- Auth: bearer/session based on deployment mode
- IDs: project_id, workflow_id, datasource_id, bucket_id, env_id
Response and Error Model
Typical success response:
{
"ok": true,
"data": {}
}
Typical error response:
{
"ok": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required field: name"
}
}
Common status patterns:
200read/update success201resource created400request validation failed401unauthorized403forbidden404resource not found409conflict (duplicate or invalid state transition)500internal server error
Quick Endpoint Index
Recommended Reading
- API Authentication
- API Projects and Workflows
- API Datasources and Buckets
- API Environments
- API Models and Training
- API Logs and Monitoring
- API Agents and Agent Tools
- API Endpoint Index
