[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	Building	Preview	Oct 21, 2026 1:02am UTC
sentry-docs	Building	Preview	Oct 21, 2026 1:02am 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, API 404s, and client errors on API pages. An issue escalates when API page loads fall or API 404s or API errors rise.

Services: sentry-docs, develop-docs.

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

Plan

What changed

The docs build now fetches the public API schema at SHA 285d9cbc. The OpenAPI JSON blob matches the previous SHA f56baf12. API documentation pages stay the same when the build succeeds. sentry-docs must deploy before this pin is live on API pages. develop-docs also deploys this shared src file. develop-docs does not render API pages.

Risk

A failed schema fetch can fail the public docs build. A broken schema can drop API routes or crash API pages. This pin uses the same JSON blob, so content risk is low. Users then see API 404s or client errors on API pages.

Intended effect

The pin has no new production counter. API pages must keep loading after deploy. absent looks like other docs page loads hold while API page loads drop.

Signal	Baseline	Window	Source	Rule
API page-load share	4.8-5.0% of all docs.page.load (0.48-0.61 TPM, 801-878 events per 24h)	2026-10-19T01:03:00Z to 2026-10-21T01:03:00Z, plus 7d 2026-10-14T01:03:00Z to 2026-10-21T01:03:00Z	Sentry org sentry, project docs, metric docs.page.load, page_type:api, environment:production	Hold the share in 4.8-5.0%. The expected shift is none. absent is a fall below that band while all docs.page.load holds.

The 7d API page-load TPM was 0.48. The two 24h samples were 0.56 then 0.61. The rate may vary with weekday traffic.

Regression watch

This pin could drop API routes or crash API page render. Watch API 404s, API-path errors, and all docs errors.

Signal	Baseline	Window	Source	Rule
API 404 share	1.3-1.8% of API page loads plus API 404s (14 per recent 24h, 15 per prior 24h)	2026-10-19T01:03:00Z to 2026-10-21T01:03:00Z, plus 7d 2026-10-14T01:03:00Z to 2026-10-21T01:03:00Z	Sentry org sentry, project docs, metric docs.page.not_found, requested_path:api*, environment:production, divided by docs.page.load page_type:api plus those 404s	Hold in 1.3-1.8%. A rise above the band is a regression.
API-path error rate	0.80-0.87% of API page loads (7 errors in each 24h sample)	2026-10-19T01:03:00Z to 2026-10-21T01:03:00Z	Sentry org sentry, project docs, errors environment:production and http.url:*/api/* or transaction:*/api/*, divided by docs.page.load page_type:api	Hold in 0.80-0.87%. A rise above the band is a regression. The rate may move because counts are low.
Docs error rate	0.73-1.34% of all docs.page.load (128 errors in the recent 24h, 223 in the prior 24h)	2026-10-19T01:03:00Z to 2026-10-21T01:03:00Z	Sentry org sentry, project docs, errors environment:production, divided by all docs.page.load environment:production	Hold in 0.73-1.34%. A rise above the band is a regression. The rate moved across the two days.

If the API 404 share rises, inspect requested_path for missing endpoint slugs. If the API-path error rate rises, inspect client exceptions on API pages.

Not observable

Production telemetry does not show the live schema SHA. Page body content is not compared to the OpenAPI JSON. The JSON blob did not change, so no new endpoint volume exists. develop-docs has no API page-load signal. The develop-docs error rate lacks a measured page-load denominator.