API Reference
The coordinator exposes a REST API on the same port as the dashboard (default 7420). All endpoints require the Authorization: Bearer <api-key> header.
POST /api/jobs
Section titled “POST /api/jobs”Dispatch a new job.
{ "prompt": "Summarize this document", "input": "...", "provider": "claude", "model": "haiku", "priority": "normal", "tier": "medium", "tags": ["summarize"]}GET /api/jobs/:id
Section titled “GET /api/jobs/:id”Get job details and result.
GET /api/jobs
Section titled “GET /api/jobs”List jobs. Query params: status, provider, limit, offset.
POST /api/jobs/:id/cancel
Section titled “POST /api/jobs/:id/cancel”Cancel a pending or running job.
POST /api/jobs/:id/retry
Section titled “POST /api/jobs/:id/retry”Requeue a failed or stuck job.
Workers
Section titled “Workers”GET /api/workers
Section titled “GET /api/workers”List all registered workers.
GET /api/workers/:id
Section titled “GET /api/workers/:id”Get worker details.
POST /api/workers/:id/pause
Section titled “POST /api/workers/:id/pause”Pause a worker (stops picking up new jobs).
POST /api/workers/:id/resume
Section titled “POST /api/workers/:id/resume”Resume a paused worker.
GET /api/cost/summary
Section titled “GET /api/cost/summary”Cost summary for a period. Query params: period (day, week, month).
GET /api/cost/breakdown
Section titled “GET /api/cost/breakdown”Cost breakdown by provider. Query params: period.
Health
Section titled “Health”GET /health
Section titled “GET /health”Returns 200 OK with coordinator status. No auth required.