API.md

API Reference — Core Endpoints

The coordinator exposes a REST API at http://localhost:9889 with 17 routers covering agents, tasks, locks, messages, memory, teams, sessions, and more. This page documents the most commonly used endpoints. For the complete API, start the server and visit /docs (Swagger UI).

Core

Endpoint	Method	Description
/health	GET	Server health, uptime, and statistics
/version	GET	Server version info
/dashboard	GET	Real-time web dashboard
/docs	GET	Interactive API documentation (Swagger)

Agent Management

Endpoint	Method	Description
/agents/register	POST	Register agent at session start
/agents/{id}/heartbeat	POST	Update status (auto-cleanup at 60 min)
/agents	GET	List all registered agents
/agents/{id}	DELETE	Mark agent offline

Task Management

Endpoint	Method	Description
/tasks	POST	Create a new task
/tasks	GET	List all tasks (filterable by status)
/tasks/claim	POST	Atomically claim a task
/tasks/next	GET	Get and claim highest-priority unclaimed task
/tasks/{id}/complete	POST	Mark task done
/tasks/{id}/release	POST	Release a claimed task
/tasks/{id}	DELETE	Delete a task
/tasks/auction	POST	Create a task auction for agent bidding

File Locks

Endpoint	Method	Description
/locks/acquire	POST	Acquire file lock with lease duration
/locks/{id}/renew	POST	Extend an existing lease
/locks/{id}	DELETE	Release a lock
/locks	GET	List all active locks

Messages

Endpoint	Method	Description
/messages	POST	Send message to another agent or broadcast
/messages/{agent_id}	GET	Get messages for an agent
/messages/{id}/ack	POST	Acknowledge receipt of a message

Advanced

Endpoint	Method	Description
/decisions	POST	Create a decision vote
/standup/today	GET	Get daily standup summary
/activity	GET	Activity feed
/memory/{agent_id}/store	POST	Store agent memory
/memory/stats	GET	Memory store statistics

For the complete OpenAPI spec, start the server and visit http://localhost:9889/docs.