> ## 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.

# Decisions

> Record and search architectural decisions

## Record a Decision

```bash theme={null}
POST /decisions
Authorization: Bearer ek_...

{
  "workspace_id": "ws_abc123",
  "title": "Use JWT for authentication",
  "rationale": "Stateless, works with edge deployment",
  "type": "architecture",
  "files": ["src/auth/login.ts", "src/auth/middleware.ts"]
}
```

**Response**

```json theme={null}
{
  "id": "dec_abc123",
  "title": "Use JWT for authentication",
  "rationale": "Stateless, works with edge deployment",
  "type": "architecture",
  "made_by": "usr_xyz",
  "workspace_id": "ws_abc123",
  "files": ["src/auth/login.ts"],
  "created_at": "2026-04-13T10:00:00Z"
}
```

Decisions are also typically recorded via the [`decide`](/mcp/decide) MCP tool.

***

## Search Decisions

Semantic vector search over all decisions in the workspace.

```bash theme={null}
POST /decisions/search
Authorization: Bearer ek_...

{
  "workspace_id": "ws_abc123",
  "query": "authentication and session management",
  "limit": 5
}
```

**Response**

```json theme={null}
{
  "results": [
    {
      "id": "dec_abc",
      "title": "Use JWT for authentication",
      "rationale": "Stateless, works with edge deployment",
      "type": "architecture",
      "similarity": 0.92,
      "made_by": "Developer A",
      "created_at": "2026-04-13T10:00:00Z"
    }
  ]
}
```

Search is also available via the [`search`](/mcp/search) MCP tool.

***

## List Decisions

```bash theme={null}
GET /workspaces/:id/decisions
Authorization: Bearer ek_...
```

Query params:

* `type` — filter by decision type
* `made_by` — filter by user ID
* `limit` — max results (default: 50)
* `before` — cursor for pagination

***

## Decision Types

| Type             | Description                     |
| ---------------- | ------------------------------- |
| `architecture`   | High-level system design        |
| `approach`       | Feature implementation approach |
| `implementation` | Low-level implementation detail |
| `rejection`      | Explicitly rejected alternative |
| `tradeoff`       | Documented tradeoff             |
| `convention`     | Adopted team pattern            |
| `bugfix`         | Root cause and fix              |