> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enagrams.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> The Enagrams REST API

## Base URL

```
https://api.enagrams.com
```

## Authentication

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

```bash theme={null}
Authorization: Bearer ek_your_key_here
```

Get your API key from **Dashboard → API Keys**.

## Endpoints

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

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

## Response Format

All responses use JSON. Errors include an `error` field:

```json theme={null}
{
  "error": "Unauthorized",
  "message": "Invalid API key"
}
```

## Rate Limiting

| Tier | Limit                 |
| ---- | --------------------- |
| Free | 1,000 requests / day  |
| Pro  | 50,000 requests / day |
| Team | Unlimited             |

Rate limit headers:

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

## Health Check

```bash theme={null}
GET /health
```

```json theme={null}
{
  "status": "ok",
  "version": "3.1.0"
}
```