[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 5:14pm UTC
sentry-docs	Ready	Preview	Oct 21, 2026 5:14pm 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 404 share, and API page errors. An issue escalates when API 404 share rises or those page errors rise. API reference page loads that collapse also escalate.

Services: sentry-docs, develop-docs.

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

Plan

What changed

The build pins the API schema to SHA e8dba7a51eb02705ffc062baf3f581856f6c684e. API reference pages still render from openapi-derefed.json at that pin. That OpenAPI file did not change from the prior pin. Only rpc_method_schema.json changed in the schema repo. This site does not fetch rpc_method_schema.json. sentry-docs must deploy before the pin is live on API reference pages. develop-docs also rebuilds this shared src file from the same commit. Catalog and Vercel deploy mapping name both ships. API reference pages are generated only for sentry-docs.

Risk

A schema that drops or renames endpoint slugs breaks old API reference links. Readers then get 404 pages on those paths. A bad fetch or parse can fail the sentry-docs production build. The same src file ships in develop-docs. A compile failure can fail that production ship as well.

Intended effect

This pin does not change the OpenAPI file the site fetches. No new API reference content is queryable. The live evidence is that API reference pages still load after deploy. Expected shift is none. Hold the pooled 24h load rate. Absent looks like that load rate falling below the band while other pages still load.

Signal	Baseline	Window	Rule	Source
API reference page loads	31-33 loads per hour	2026-10-19T18:00:00Z to 2026-10-21T17:00:00Z	hold the 24h pooled rate in 31-33 per hour	Sentry org sentry project docs metric docs.page.load query page_type:api environment:production

Prior 24h was 792 loads. Last 24h was 789 loads. Those map to 33 and 33 loads per hour.

Regression watch

This pin can break API reference paths if slugs change. Render can also throw on those pages if the schema fails. Watch 404 share and error share on that same path. If 404 share rises, inspect renamed endpoint slugs.

Check	Baseline	Window	Rule	Source
API 404 share	1.0-1.7% of API reference page loads	2026-10-19T18:00:00Z to 2026-10-21T17:00:00Z	hold in 1.0-1.7%. Escalate if share rises above 1.7%	Sentry org sentry project docs metric docs.page.not_found query sentry.environment:production requested_path:api* over docs.page.load page_type:api environment:production
API page error share	1.1-1.9% of API reference page loads	2026-10-19T18:00:00Z to 2026-10-21T17:00:00Z	hold in 1.1-1.9%. Escalate if share rises above 1.9%	Sentry org sentry project docs errors query environment:production http.url:*/api/* over docs.page.load page_type:api environment:production

Prior 24h had 8 API 404s and 9 API page errors on 792 loads. Last 24h had 13 API 404s and 15 API page errors on 789 loads. Last 24h 404s were mostly path api/alerts.

Not observable

No runtime metric records the schema SHA. The 48h /api/ pageload trace query timed out, so prior-day p95 is missing. Last 24h p95 was 6.4s on 477 pageload spans, and traces are sampled at 30%. develop-docs does not generate API reference pages from this schema, so that ship has no pre-ship rate on the changed path.