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

Closed opened this has it

Landed in pull #14345 · run

opened this

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.

2 earlier comments
commented

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..

commented

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.

commented

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.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs