[aryasaatvik]

Summary

The Consume example now pins v0.28.0, the current maintained release, so a copy-paste consumer downloads an OpenAPI document that includes webhooks.

Before / After

-version=v0.20.0
+version=v0.28.0
 curl -fsSLO "https://github.com/SamvaHQ/samva-openapi/releases/download/$version/openapi.json"
 curl -fsSLO "https://github.com/SamvaHQ/samva-openapi/releases/download/$version/SHA256SUMS"
 shasum -a 256 -c SHA256SUMS

gh release list marks v0.28.0 Latest (published 2026-10-19T20:01:16Z). manifest.json is 0.28.0 with 36 webhook events. COMPATIBILITY.md maintains only the current 0.x release. The pin stays a concrete tag.

Assets

Published v0.20.0 openapi.json top-level keys: components, info, openapi, paths, security, servers, tags. No webhooks.

$ curl -fsSI -o /dev/null -w '%{http_code}\n' \
    https://github.com/SamvaHQ/samva-openapi/releases/download/v0.28.0/openapi.json
302
$ curl -fsSL -o /dev/null -w '%{http_code} %{size_download}\n' \
    https://github.com/SamvaHQ/samva-openapi/releases/download/v0.28.0/openapi.json
200 2499489

$ curl -fsSI -o /dev/null -w '%{http_code}\n' \
    https://github.com/SamvaHQ/samva-openapi/releases/download/v0.28.0/SHA256SUMS
302
$ curl -fsSL -o /dev/null -w '%{http_code} %{size_download}\n' \
    https://github.com/SamvaHQ/samva-openapi/releases/download/v0.28.0/SHA256SUMS
200 79

The downloaded v0.28.0 document has 36 webhook events. Its SHA-256 matches the release SHA256SUMS and manifest.json:

a1d0387df8e6445c4b6a7f207edad1b79baf0a6d642d64d8829f7fd8bce241e3  openapi.json

Checks

$ bun install --frozen-lockfile && bun run validate
bun install v1.4.0 (34cbb9a40)
+ @redocly/cli@2.49.0
1 package installed [128.00ms]
$ node --test scripts/channel-vocabulary.test.mjs
# tests 5
# pass 5
# fail 0
$ node scripts/validate.mjs
Validated v0.28.0: 331 operations, a1d0387df8e6445c4b6a7f207edad1b79baf0a6d642d64d8829f7fd8bce241e3
$ redocly lint openapi.json
Woohoo! Your API description is valid.

README, COMPATIBILITY, CONTRIBUTING, and SECURITY were checked against manifest.json and scripts/. No other count, filename, or command was provably stale. The v0.18.0 to v0.20.0 history sentence is unchanged. openapi.json, manifest.json, SHA256SUMS, and scripts/ are unchanged.

  

[greptile-apps]

Confidence Score: 5/5

[Low impact] The documentation change appears safe to merge.

Summary

Updates the consume example from v0.20.0 to v0.28.0.

• The Consume example points to the v0.28.0 release.

_{Reviews (1) · Last reviewed commit: "docs: pin the consume example to v0.28.0" · Reviewed by Greptile}