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

Services: sentry-docs.

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

Plan

What changed

The production build fetches the OpenAPI schema from SHA 0dbafd12. Pages under /api/ still come from that schema at build. The OpenAPI document at this SHA is unchanged from the previous SHA. Only api_ownership_stats_dont_modify.json changed in the schema repository. sentry-docs must deploy before the new pin is live. develop-docs rebuilds this file but does not call apiCategories and does not serve /api/ pages.

Risk

A broken schema can omit /api/ routes from the static page list. Readers then get 404 pages for API documentation. Bad endpoint markdown can crash the API page during render or hydration. That blast stays on /api/ pages. This pin does not change the OpenAPI document, so that risk is low.

Intended effect

API documentation pages keep loading after the rebuild. The pin adds no new page-load metric. Absent looks like page_type api loads near zero while other page loads hold. No content shift is expected. Hold the API share in the measured band.

Signal	Baseline	Window	Source	Rule
API share of docs.page.load	2.4-4.5% of all page loads. Last 24h 679 of 15223. Prior 24h 404 of 16646. Monday traffic sits at the high end of this band.	2026-10-17T16:58:00Z to 2026-10-19T16:58:00Z	Sentry metrics, sentry/docs, production. API count: metric.name:docs.page.load AND page_type:api AND environment:production. All count: metric.name:docs.page.load AND environment:production.	Hold in band. Fall well below 2.4% while all page loads hold means the change is absent.

Regression watch

This pin can drop /api/ static routes or crash those pages. Watch API 404s and errors on /api/ URLs. API 404s are the user-visible miss. Errors on those URLs are the crash symptom. The prior 24h had an error flood on /api/ URLs. That flood is not the normal band.

Signal	Baseline	Window	Source	Rule
API 404 rate	1.5-2.1% of API page loads. Last 24h 14 not_found and 679 loads. Prior 24h 6 not_found and 404 loads.	2026-10-17T16:58:00Z to 2026-10-19T16:58:00Z	Sentry metrics, sentry/docs, production. 404s: metric.name:docs.page.not_found AND environment:production AND requested_path:api*. Pair with page_type api docs.page.load.	Hold in band. Rise above 2.1% of API page loads is detected.
Errors on /api/ URLs	Last 24h 4 events, 0.6% of 679 API page loads. Titles were TypeError on xS, reCAPTCHA Timeout, and Algolia fetch. Prior 24h 278 events. That prior count is a flood and is not the band.	Calm baseline 2026-10-18T16:58:00Z to 2026-10-19T16:58:00Z. Prior 24h sampled and rejected as flood.	Sentry errors, sentry/docs, production. Query: environment:production url:"*/api/*".	Hold near the last-24h 0.6% rate. Rise to tens or hundreds of events in 24h is detected. Do not treat 278 as normal.

Not observable

Exact API documentation text is not in telemetry. Vercel schema fetch has no production signal. A failed fetch blocks the deploy. Prior 24h p95 for /api/ pageload spans is unknown. The 2d traces query timed out. Last 24h p95 was 4412ms over 563 spans. Traces are sampled at 30%. develop-docs has no /api/ page signal.