lightsparkdev · shreyav · Jul 10, 2026 · Jul 10, 2026
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -6,6 +6,7 @@ Grid is an API for global payments across fiat, stablecoins, and Bitcoin.
 ## Critical Rules
 
 - **Edit OpenAPI in `openapi/`** — never edit the root `openapi.yaml` directly (it's generated by bundling)
+- **Bump `info.version` only when a breaking change ships** — at which point it should match a new `servers.url` path
 - Run `make build` after any OpenAPI changes to rebundle
 - Run `make lint` before committing
 - **Mintlify CLI must be version 4.2.284** — newer versions (e.g., 4.2.312) have a bug where API reference pages render blank. Install with `npm install -g mintlify@4.2.284 --force`

diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
diff --git a/openapi.yaml b/openapi.yaml
diff --git a/openapi/openapi.yaml b/openapi/openapi.yaml