[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 12:58pm UTC
sentry-docs	Ready	Preview	Oct 21, 2026 12:58pm 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 page loads and API 404s. An issue escalates when API page loads fall or the API 404 share rises.

Services: sentry-docs, develop-docs.

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

Plan

What changed

The production build fetches OpenAPI schema SHA f5e2db97. API pages rebuild from that pin.
The schema JSON matches SHA dc40ad2. API pages do not add new operations.
sentry-docs must deploy for API pages to go live. develop-docs deploys the same file.
It does not render API pages. These signals apply after the sentry-docs production deploy.

Risk

A bad schema fetch or parse omits API pages at build time. Readers then get 404s on API URLs.
A render crash on those pages also fails the API section.

Intended effect

This pin does not add a metric. Rendered operations stay the same.
Confirm the rebuild still serves API pages. docs.page.load with page_type:api should hold.
Absent: that load count falls toward zero while other docs pages still load.

Signal	Baseline	Window	Rule	Source
docs.page.load page_type:api	788-818 loads per 24h	2026-10-19T12:52:40Z to 2026-10-21T12:52:40Z	Hold near this weekday band. Complete 7d days spanned 290-965 loads. Absent if a weekday 24h value falls below 290.	Sentry org sentry project docs. sum(value, docs.page.load, counter, none) with page_type:api environment:production. Last 24h was 788. Prior 24h was 818.

Regression watch

A bad pin 404s API URLs. Page-load collapse on the same path also shows omitted pages.

Signal	Baseline	Window	Rule	Source
API 404 share	1.2-1.9% of API page loads	2026-10-19T12:52:40Z to 2026-10-21T12:52:40Z	Hold in this band. Escalate if the share rises above 1.9% on a like 24h window. Complete 7d days reached 2.4% on 2026-10-18.	Sentry org sentry project docs. docs.page.not_found with requested_path:api* environment:production over docs.page.load page_type:api. Last 24h was 15/788. Prior 24h was 10/818.
docs.page.load page_type:api	788-818 loads per 24h	2026-10-19T12:52:40Z to 2026-10-21T12:52:40Z	Hold near this weekday band. A weekday drop below 290 means API pages are missing.	Same query as Intended effect.

If the 404 share rises, inspect API URL slugs that 404.

Not observable

The live schema SHA is not in telemetry.
API-page error events have no 48h rate. transaction:*/api/* returned 0 errors in 24h.
Pageloads with url.path:/api/* and span.status:error were 27 in 2026-10-20T12:52:40Z to 2026-10-21T12:52:40Z only.
Do not file a regression from that 24h error-span count alone.
develop-docs has no API-page signals. It does not serve those pages.