Agents API
Today only
GET /v1/agents (list agents in a lab) is shipped. The per-agent sub-routes described below (GET /v1/agents/{id}, /messages, /metrics, /start, /stop) are planned, not yet live. Drive individual agents from the web app or via Convex actions; this page documents the target REST shape so SDKs can build against it.Agent Roles
Agent Status
Create an Agent
Model identifier (e.g.,
claude-opus-4-8, claude-sonnet-5, claude-haiku-4-5, gpt-5.5, gemini-3.1-pro, grok-4, sonar-pro).Convex ID of the agent this one reports to. Workers report to leads; leads report to the orchestrator.
List Agents
Get an Agent
Update an Agent
Start an Agent
Activate a retired or newly created agent so it begins receiving tasks.Stop an Agent
Set an agent toretired status. It finishes any in-progress task, then stops accepting new work.
Delete an Agent
Remove an agent from the lab. The agent must be inretired status.