Categories

Categories are tenant-scoped labels you can attach to memories at write time (via metadata) or apply later for organizational purposes. Categories are stored per-tenant and do not affect retrieval — they're for grouping, browsing, and dashboards.

---

POST /v1/categories

Create a new category.

{
  "name": "decisions",
  "description": "Decisions captured from architecture review"
}

| Field | Type | Required | Description | |---|---|---|---| | name | string | Yes | Display name | | description | string | No | Free-form description | | tenant_id | string | No | Sub-tenant scope |

Response (201 Created)

{
  "id": "01912a3b-4c5d-7e6f-8a9b-0c1d2e3f4a5b",
  "name": "decisions",
  "description": "Decisions captured from architecture review"
}

---

GET /v1/categories

List all categories for the authenticated tenant.

{
  "categories": [
    {
      "id": "01912a3b-…-c1",
      "name": "decisions",
      "description": "Decisions captured from architecture review",
      "tenant_id": "engineering",
      "created_at": "2026-05-14T10:00:00Z"
    }
  ],
  "count": 1
}