API Reference
Libraries
API Overview
Agents
List agents
GET/api/agents/
Create agent
POST/api/agents/
Get agent
GET/api/agents/{id}/
Update agent
PATCH/api/agents/{id}/
Soft-delete agent
DELETE/api/agents/{id}/
Get agent eval spec
GET/api/agents/{id}/eval_spec/
Auth
Current user profile
GET/api/auth/me/
Register
POST/api/auth/register/
AuthAPI Keys
List API tokens
GET/api/auth/api-keys/
Generate API token
POST/api/auth/api-keys/
Revoke API token
DELETE/api/auth/api-keys/{id}/
Datasets
List datasets
GET/api/datasets/
Create dataset (auto-increments version per agent)
POST/api/datasets/
Get dataset (with datapoints)
GET/api/datasets/{id}/
Delete dataset version
DELETE/api/datasets/{id}/
Activate dataset
POST/api/datasets/{id}/activate/
List datapoints for a dataset
GET/api/datasets/{id}/datapoints/
Job Iterations
List job iterations
GET/api/job-iterations/
Create job iteration
POST/api/job-iterations/
Get job iteration
GET/api/job-iterations/{id}/
Update job iteration
PATCH/api/job-iterations/{id}/
Delete job iteration
DELETE/api/job-iterations/{id}/
Jobs
List jobs
GET/api/jobs/
Create job
POST/api/jobs/
Get job (with iterations)
GET/api/jobs/{id}/
Update job
PATCH/api/jobs/{id}/
Delete job
DELETE/api/jobs/{id}/
Projects
List projects
GET/api/projects/
Create project
POST/api/projects/
Get project
GET/api/projects/{id}/
Update project
PATCH/api/projects/{id}/
Delete project
DELETE/api/projects/{id}/
ProjectsMemberships
List project members
GET/api/projects/{project_id}/memberships/
Add a user to the project
POST/api/projects/{project_id}/memberships/
Remove a user from the project
DELETE/api/projects/{project_id}/memberships/{id}/
Traces
List traces (root spans)
GET/api/traces/
Get a trace and all its spans
GET/api/traces/{trace_id}/
List distinct service names visible to the caller
GET/api/traces/services/
Health
Check
GET/health