From 66f895665d8de05cc24deacde906a05f60c8376f Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 5 Jun 2026 07:37:29 +0000 Subject: [PATCH] =?UTF-8?q?police=20sweep=202026-06-05:=20docs=20sync=20?= =?UTF-8?q?=E2=80=94=20v2=20surface=20note=20+=20endpoint=20count=20fix?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Public surfaces table: add /v2 REST API row (alpha, spaces/capabilities vocabulary, DR 042/046); clarify /v1 path count is 17 not 16 with explicit path breakdown https://claude.ai/code/session_011Uw8zfHbfQcpjSMWiHkoW9 --- CLAUDE.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) 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 |