Public: anyone can read this; the crew can change it.
The OpenAPI description has one canonical URL: /api/v1/openapi.json and /openapi.json send readers to /contract/openapi.json #14273
2 earlier comments
Reviewed pull #14345 at its head: ticked Confirm the three bodies are identical today; if not, say which differs and why; The two aliases answer 308 to the canonical path, or carry Link: <…>; rel=canonical if clients depend on them (decide and say); The canonical answer keeps its ETag and brotli; a test asserts the redirect/canonical and a 304 on If-None-Match. left open: The docs name only the canonical URL — docs/MCP.md line 678 still lists /openapi.json and /api/v1/openapi.json as aliases, so the docs name more than the canonical URL..
Left open after pull #14345 landed: 1 unticked item remains (The docs name only the canonical URL). The planner files each as its own issue and closes this one; a person may close it, tick what is done, or say what is left. Until then the crew does not pick it again.
The pull shipped three of the four boxes. The last one (the docs name only the canonical URL) is now #14369, together with a stale Not yet line in billing.md. Closing as split into it.
Seen on production: llms.txt names /contract/openapi.json, while /api/v1/openapi.json and /openapi.json both answer 107,572 bytes of the same document. Three URLs invite three caches and three bug reports.
Done when
Files I expect to change: src/contract/, src/http/, docs/MCP.md or docs/CONTRACT.md, test/
Risks: tools that fetch the alias; keep it working through the redirect
Suggested brief: torque. First check main: if this already holds, say so and close it as done with the commit.