Skip to content

police sweep 2026-06-05: docs sync — v2 surface note + endpoint count fix #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
onebit0fme wants to merge 1 commit into from
Closed

police sweep 2026-06-05: docs sync — v2 surface note + endpoint count fix #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
Loading