[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 27, 2026 8:00pm UTC
sentry-docs	Ready	Preview	Oct 27, 2026 8:00pm 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 path 404s, and client errors. An issue escalates when API pages stop loading, those 404s rise, or new client errors appear.

Monitoring in production

Services: sentry-docs.

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

Plan

What changed

The docs build fetches the public OpenAPI file at commit 978abb76. That commit does not change the dereferenced OpenAPI document. Live API docs pages keep the same endpoint list after a successful deploy. sentry-docs must deploy to production before this change is live.

Risk

A missing or invalid schema file fails the Vercel build. Then this change never reaches production. If static paths for API docs drop, those URLs return 404. A full site rebuild can also ship broken client scripts on API pages.

Intended effect

This pin does not add or remove API endpoint pages. There is no new-content signal. Use API page loads as a proxy that the rebuild still serves those pages. absent looks like docs.page.load with page_type=api falling toward zero while other page_type values hold.

Signal	Baseline	Window	Rule	Source
Share of docs.page.load with page_type=api	3.9-5.8% of all docs.page.load	2026-10-25T19:52:46Z to 2026-10-26T19:52:46Z was 1060 of 18198. 2026-10-26T19:52:46Z to 2026-10-27T19:52:46Z was 749 of 19300	Hold in the band. absent if the share falls below 2% while other page_type values hold	Sentry org sentry project docs, metric docs.page.load, environment:production

Regression watch

Dropped API routes show up as 404s on /api/ paths. A broken static page shows up as a 5xx pageload. A bad client bundle shows up as a rise in production errors.

Signal	Baseline	Window	Rule	Source
Share of API-path 404s	0.4-1.7% of API-path volume	2026-10-25T19:52:46Z to 2026-10-26T19:52:46Z was 4 of 1064. 2026-10-26T19:52:46Z to 2026-10-27T19:52:46Z was 13 of 762	Hold in the band. Detected if the share rises above 3% while API page loads hold	Sentry org sentry project docs, metric docs.page.not_found with requested_path:api*, environment:production
/api/ pageload 5xx	0 of 2197 sampled pageload and navigation spans	2026-10-25T19:52:46Z to 2026-10-27T19:52:46Z	Hold at 0	Sentry org sentry project docs, spans span.op:[pageload,navigation] url.full:*/api/* http.response_status_code:>=500, environment:production. Traces are sampled at 30%
Production error rate	4.1-4.9% of docs.page.load	2026-10-25T19:52:46Z to 2026-10-26T19:52:46Z was 882 of 18198. 2026-10-26T19:52:46Z to 2026-10-27T19:52:46Z was 797 of 19300	Hold in the band. The title Event: Event \Event` (type=error) captured as promise rejection` was 697 of 797 errors in the later window. Detected if the rate rises above the band, or if new TypeError titles appear	Sentry org sentry project docs, error events environment:production

If the 404 share rises, inspect requested_path on docs.page.not_found for dropped categories.

Not observable

The build-time GitHub fetch of the schema commit is not in production telemetry. Sentry error events do not use /api/ transaction names. Per-endpoint page content is not measured.