[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 8:41pm UTC
sentry-docs	Ready	Preview	Oct 15, 2026 8:41pm 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]

API reference pages rebuild from a newer OpenAPI snapshot. The plan checks those page loads, API 404s, and API page errors. An issue escalates when 404s rise or those errors appear.

Services: sentry-docs.

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

Plan

What changed

API reference pages now render from OpenAPI snapshot b03c02fb. Category and endpoint URLs under /api/ come from that snapshot. sentry-docs must deploy this commit before those pages change. develop-docs rebuilds the same repository but does not generate API pages.

Risk

A bad snapshot can drop or rename endpoint pages. Readers then hit 404s on old API URLs. Schema text the page cannot parse can crash API pages. Other docs routes do not read this snapshot at request time.

Intended effect

The new snapshot text on each API page is not in telemetry. Treat successful API page loads as the reachable proxy. absent means that load count falls toward 0 while API 404s rise or hold.

Signal	Baseline	Rule	Source
API page loads	780-914 loads per 24h	Hold in this band. The bump should not move traffic. absent if the count falls toward 0.	Sentry metrics, org sentry, project docs. Query page_type:api environment:production. Sum docs.page.load. Window 2026-10-13T20:35Z to 2026-10-14T20:35Z is 780. Window 2026-10-14T20:35Z to 2026-10-15T20:35Z is 914. 48h sum is 1694.

Regression watch

Watch API 404s first. A removed or renamed endpoint shows there. Watch API page errors next. A renderer crash on new schema text shows there. Site-wide 404s catch a broken static deploy on the same ship.

Signal	Baseline	Rule	Source
API 404 share	0.4% share. 4 not-found events against 914 API page loads in 2026-10-14T20:35Z to 2026-10-15T20:35Z.	Hold near this share. Four events is a small count and may move a little. Escalate if the share rises while loads stay in band.	Sentry metrics, project docs. Query requested_path:api* sentry.environment:production. Sum docs.page.not_found. Pair with the API page load count above.
API page errors	0 error events and 0 error-status page spans in that 24h	Hold at 0.	Sentry errors, project docs, environment:production transaction:/api*. Sentry traces span.op:[pageload,navigation] url.full:"*/api/*" sentry.environment:production with error status.
Site-wide 404s	61 not-found events in 2026-10-14T20:35Z to 2026-10-15T20:35Z	Hold near 61 per 24h. Escalate if this jumps with API 404s.	Sentry metrics, project docs. Query environment:production. Sum docs.page.not_found.

Not observable

The 12-line OpenAPI snapshot delta is not in telemetry. Prior-day API 404 count was not measured. Prior-day API pageload p95 timed out. Site-wide page load volume timed out. New endpoint slugs have no traffic until readers open them.