[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 8:38pm UTC
sentry-docs	Ready	Preview	Oct 21, 2026 8:38pm 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 errors on API URLs. An issue escalates when those 404s or errors rise. This pin uses the same OpenAPI document, so page content should not change.

Services: sentry-docs.

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

Plan

What changed

The docs build now fetches the OpenAPI schema from SHA 65ff00aa. That openapi-derefed.json file matches the previous pin 277e2b11. Generated /api/ reference pages should stay the same. sentry-docs must deploy on Vercel before this pin is live. The catalog and the Production – sentry-docs deploy report both name that ship. develop-docs builds the same repository but does not fetch this schema or render those pages.

Risk

A failed schema fetch can fail the production build. A dropped or renamed endpoint would 404 former API URLs. A render throw would show errors on API reference pages. The OpenAPI file did not change, so those breaks are unlikely if the fetch succeeds.

Intended effect

This pin does not change the generated OpenAPI document. No new API page or metric should appear. The intended-effect axis is not queryable. Report it unknown. Do not treat a flat new-page count as absent.

Regression watch

Watch the /api/ reference path that this pin rebuilds. A missing page shows as a 404. A broken page shows as an error event. A lost section shows as a drop in API page loads. The error URL filter also matches /api/ip-ranges and /api/source-map.

Signal	Baseline	Window	Rule	Source
API page load rate	0.47-0.55 per minute	2026-10-14T20:35:12Z to 2026-10-21T20:35:12Z	hold in band	Sentry org sentry project docs. Metric docs.page.load. Query page_type:api environment:production. 7d sum 4716. 24h sum 788. 48h sum 1581.
API 404 share	1.4-1.9% of API page loads plus API 404s	2026-10-19T20:35:12Z to 2026-10-21T20:35:12Z	hold in band. Rise above the band	Sentry org sentry project docs. Metric docs.page.not_found. Query requested_path:api* environment:production. 24h: 11 404s and 788 loads. Prior 24h: 15 404s and 793 loads.
/api/ error ratio	0.9-1.8% of API page loads	2026-10-19T20:35:12Z to 2026-10-21T20:35:12Z	hold in band. Rise above the band	Sentry org sentry project docs. Errors query environment:production http.url:*/api/*. 24h: 14 errors. 48h: 21 errors.

Not observable

The 7d API 404 total timed out, so the 404 band uses 48h only. A same-query 24h and 7d p95 for transaction:*/api/* was not measured. Vercel build logs that would show a failed schema fetch are not connected. The running site does not expose SHA 65ff00aa.