[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 15, 2026 3:55pm UTC
sentry-docs	Ready	Preview	Oct 15, 2026 3:55pm 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 pin rebuilds API reference pages from a new schema commit. That commit does not change the OpenAPI document. The plan checks API page loads, API not-found events, client errors on API URLs, and API pageload latency. An issue escalates when API not-found events or client errors rise, or when API page loads fall.

Services: sentry-docs.

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

Plan

What changed

The production site builds API reference pages from OpenAPI schema SHA 2ac86ef11fe40f977020cd9fa638de915415aee2. Those pages stay at /api/<category>/<endpoint>/ URLs. The OpenAPI file at this SHA matches the prior pin. sentry-docs must deploy before this pin is live.

Risk

A missing or invalid schema file would fail the production build. A pin that dropped endpoints would 404 old API URLs. This pin does not drop endpoints. A broken API page render would throw in the client. Other docs paths share the catch-all route. This pin only feeds API frontmatter, so other paths should not change.

Intended effect

This pin does not change the OpenAPI document. Production has no new API page or new counter to confirm. Do not treat a steady API page-load count as proof the pin worked. Report intended effect as unknown.

Regression watch

Watch the API docs path only. Traces on this path use transaction /:path*?. Traces are sampled at 30 percent. The 24h error titles were third-party fetch failures and one TypeError on mw. Escalate when the error rate rises above the band, or when new first-party render titles appear on API URLs. The not-found query uses requested_path:*api* and may include a later segment that contains api.

Signal	Band	Window	Source	Rule
API page-load rate	0.55-0.59 per minute	2026-10-13T15:50Z to 2026-10-15T15:50Z	Sentry sentry/docs metric docs.page.load query page_type:api environment:production	Hold in band. Recent 24h was 796. Prior 24h was 848.
API not-found rate	0.6-1.4% of API page-load plus not-found events	2026-10-13T15:50Z to 2026-10-15T15:50Z	Sentry sentry/docs metric docs.page.not_found query requested_path:*api* environment:production	Hold in band. Recent 24h was 5 not-found vs 796 loads. Prior 24h was 12 vs 848. This rate may be noisy at this volume.
API URL error rate	0.38-0.47% of API page loads	2026-10-13T15:50Z to 2026-10-15T15:50Z	Sentry sentry/docs errors query environment:production http.url:*/api/*	Hold in band. Recent 24h was 3 errors. Prior 24h was 4. This count is low. A few extra third-party fetch failures can move the rate.
API pageload p95	6.5-7.4s	2026-10-13T15:50Z to 2026-10-15T15:50Z	Sentry sentry/docs traces query span.op:pageload environment:production url.full:*docs.sentry.io/api*	Hold in band. Last 24h p95 was 6.5s on 323 sampled pageloads. Last 48h p95 was 7.4s on 637 sampled pageloads.

Not observable

The running site does not emit the schema SHA. That value is chosen at build time only.