API Overview - Enagrams

Base URL

https://api.enagrams.com

All API requests require an API key passed as a Bearer token:

Authorization: Bearer ek_your_key_here

Get your API key from Dashboard → API Keys.

Category	Endpoints
Auth	Key validation, user profile
Workspaces	CRUD, members, sessions, reservations, feed
Decisions	Record, search, staleness, reaffirmation
Sessions	Agent session management and hooks
Meetings	Transcript ingestion and live recording
Workstreams	`GET/POST/PATCH/DELETE /workspaces/:id/workstreams` — branch-scoped units of work. See Workstreams.
Tasks	`POST/GET/PATCH /workspaces/:id/tasks` — delegated follow-up inside a workstream. See Tasks.
Conventions	`POST/GET /workspaces/:id/conventions` — team rules. See Conventions.
Negotiations	`POST/GET /workspaces/:id/negotiations` — contested-symbol turn machine. See Negotiation.
Test gate	`POST /workspaces/:id/sync/confirm`, `/sync/commit`, `/sync/retract`. See Test gate.
Symbols	`GET /workspaces/:id/symbols` — query the symbol graph.

Most coordination actions can be driven through either HTTP (for dashboards and CI) or the MCP tools (for agents).

All responses use JSON. Errors include an error field:

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Rate limit headers:

X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 49823
X-RateLimit-Reset: 1713000000

GET /health

{
  "status": "ok",
  "version": "3.1.0"
}