[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 16, 2026 8:19pm UTC
sentry-docs	Ready	Preview	Oct 16, 2026 8:19pm 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 reference page loads, API 404s, and errors on those pages. An issue escalates when API page loads fall or API 404s rise.

Services: sentry-docs.

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

Plan

What changed

API reference pages now build from OpenAPI schema pin f8bf85ea. The schema file matches the prior pin. The two pins differ only in changelog and package files. sentry-docs must deploy before this pin is live. develop-docs also rebuilds from this commit. That site does not fetch the OpenAPI schema, so it is not in services.

Risk

A bad pin fails the production build. A broken schema omits API pages or serves 404. Malformed endpoint text can throw in the API page renderer. Users then lose API reference pages.

Intended effect

The pin does not add or change endpoint pages. Success is that API pages still load at the baseline share. Absent means that share falls below the band while other page types hold. Sentry does not expose the live schema SHA.

Signal	Baseline	Window	Rule	Source
API page load share	4.6-4.8% of all page loads. Last 24h was 771 of 15941. Prior 24h was 904 of 19793.	2026-10-14T20:15:51Z to 2026-10-16T20:15:51Z	Hold in the band.	Sentry metrics in org sentry, project docs. docs.page.load with page_type:api environment:production. Divide by all docs.page.load in production.

Regression watch

A bad schema first shows as 404s or errors on API pages. If 404s rise, group docs.page.not_found by requested_path. Last 24h API 404s were api/alerts 5, api/projects 1, api/discover 1, and api/guides 1.

Signal	Baseline	Window	Rule	Source
API 404 share	0.4-1.0% of API page attempts. Prior 24h was 4 of 908. Last 24h was 8 of 779.	2026-10-14T20:15:51Z to 2026-10-16T20:15:51Z	Stay in or below the band.	Sentry metrics in org sentry, project docs. docs.page.not_found with environment:production and requested_path starting with api. Attempts are API page loads plus those 404s.
Errors on API pages	0.2-0.4% of API page loads. Prior 24h was 2 of 904. Last 24h was 3 of 771. These counts are small and may move with traffic.	2026-10-14T20:15:51Z to 2026-10-16T20:15:51Z	Stay in or below the band.	Sentry errors in org sentry, project docs. Production errors whose URL contains /api/. Denominator is docs.page.load with page_type:api.
HTTP 5xx on API pageloads	0 in the last 24h. The prior 24h was not measured.	2026-10-15T20:15:51Z to 2026-10-16T20:15:51Z	Hold at 0.	Sentry traces in org sentry, project docs. span.op:[pageload,navigation] url.path:/api/* environment:production with http.status_code 500 or higher. Traces are sampled at 30%.

Not observable

Sentry does not record the schema SHA from the built site. Endpoint body text is not in telemetry. Pageload p95 on API pages is too noisy for a rule.