[sentry-api-schema-updater]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
develop-docs	Ready	Preview	Oct 21, 2026 2:10pm UTC
sentry-docs	Ready	Preview	Oct 21, 2026 2:10pm UTC

[github-actions]

Please update the IS YOUR CHANGE URGENT? section of the PR description:

• Select exactly one option.
• If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.

[cursor]

The plan checks API page loads, API not-found counts, and production error events. An issue escalates when API page loads fall or API not-found counts rise. Error events on the catch-all docs page also escalate the watch.

Services: sentry-docs, develop-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

The public API reference rebuilds from OpenAPI schema SHA 03b63c05. Requests to API docs pages keep the same endpoint list as SHA 2c407fef. sentry-docs must deploy before this change is live. develop-docs also ships the shared source file. develop-docs does not fetch or render this schema. The two schema SHAs differ only in changelog and package version. The OpenAPI document does not change paths.

Risk

A failed schema fetch blocks the sentry-docs production build. Readers then keep the previous API pages until a later ship. A dropped or renamed operation would 404 that API page. A broken schema would throw on the shared catch-all page.

Intended effect

The pin adds no new endpoint and no new metric. Treat a hold in API page loads as confirmed. Absent looks like API page loads falling below the band. Other page types would still hold in that case. Last 24h API share was 4.3 percent of 17263 page loads.

Signal	Baseline	Rule	Source
API page loads	0.52-0.59 TPM. 750 loads in 2026-10-20T14:05:17Z to 2026-10-21T14:05:17Z. 854 loads in 2026-10-19T14:05:17Z to 2026-10-20T14:05:17Z.	Hold in the band. The expected shift is none.	Sentry org sentry project docs. Metric docs.page.load. Query page_type:api environment:production. Field sum(value, docs.page.load, counter, none).

Regression watch

This diff could 404 API pages or throw in API page render. Watch API not-found counts against API page loads. Watch production error events on the docs catch-all transaction.

Signal	Baseline	Rule	Source
API not-found rate	1.1-2.0 percent of API page loads. 15 not-found and 750 loads in 2026-10-20T14:05:17Z to 2026-10-21T14:05:17Z. At least 9 not-found and 854 loads in 2026-10-19T14:05:17Z to 2026-10-20T14:05:17Z.	Stay in the band. Rise above 2.0 percent is a regression.	Sentry org sentry project docs. Metric docs.page.not_found. Query environment:production requested_path:api*. Divide by docs.page.load with page_type:api environment:production.
Docs error events	161-219 events per 24h. 219 events in 2026-10-20T14:05:17Z to 2026-10-21T14:05:17Z. 161 events in 2026-10-19T14:05:17Z to 2026-10-20T14:05:17Z. Last 24h rate was 1.27 percent of 17263 page loads.	Stay in the 161-219 band. Rise above the band is a regression.	Sentry org sentry project docs. Errors query environment:production. Field count(). Catch-all transaction /:path*? held 151 of the 219 last-24h events.

Not observable

Pageload spans with transaction /api/ returned zero rows. Docs pages use the catch-all transaction /:path*?. The 48 hour API not-found group query capped at ten paths. The prior-day total page load count was not measured. No signal shows which endpoint pages the build emitted.