diff --git a/CLAUDE.md b/CLAUDE.md
index fbe5aa9..36fc0c9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -54,7 +54,8 @@ The **public programmatic surface is HTTP**: the REST API and the product MCP se
 
 | Surface | What it is | Canonical truth |
 |---|---|---|
-| **REST API** | `https://u22a8.ai/v1` — resource-shaped, key-authenticated. 16 resource paths under `/v1/models/{handle}/…` (`score`, `compare`, `samples`, `traits`, `train`, `versions`) plus `/v1/extract`. | `api-reference/openapi.json` (snapshot of the live spec) |
+| **REST API** | `https://u22a8.ai/v1` — resource-shaped, key-authenticated. 17 paths: resources under `/v1/models/{handle}/…` (`score`, `compare`, `samples`, `traits`, `train`, `versions`) plus `/v1/models`, `/v1/models/{handle}`, `/v1/extract`, and `/v1/health`. | `api-reference/openapi.json` (snapshot of the live spec) |
+| **REST API v2** | `https://u22a8.ai/v2` — **alpha**, spaces/capabilities vocabulary (DR 042/046). Exposes `/v2/spaces`, `/v2/scoring/{handle}/…`, `/v2/identity`. Not yet documented; do not reference in stable docs pages. | The live server (alpha) |
 | **Product MCP** | `https://u22a8.ai/mcp` — OAuth (WorkOS) MCP server exposing reading / scoring / authoring / lifecycle tools, and models as readable resources (model-card markdown). | The live server + the tool list below |
 | **Console** | `https://u22a8.ai/console` — WorkOS magic-link sign-in, **API-key management** (scoped at issuance), per-key usage. Where developers get a key. | The live console |
 | **Authoring schemas** | `model.yaml` + JSONL samples — the published training-input contract (DR 009), at `u22a8.ai/schemas`. | The published JSON Schemas |