[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 26, 2026 8:51pm UTC
sentry-docs	Ready	Preview	Oct 26, 2026 8:51pm 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 5xx on API docs pages. An issue escalates when API 404s rise as a share of API loads or 5xx responses appear. API docs pages should keep the same endpoints after this pin bump.

Monitoring in production

Services: sentry-docs, develop-docs.

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

Plan

What changed

The docs build now fetches OpenAPI schema pin 0c5dd3da. The openapi-derefed.json at that pin matches the previous pin. API docs pages should keep the same endpoints and URLs. sentry-docs must deploy before those pages are live. develop-docs also rebuilds from this src file. develop-docs does not serve OpenAPI pages. Catalog and Vercel Production deploys name both services for this src path.

Risk

A missing or invalid schema pin fails the sentry-docs build. Readers then hit 404s on API category and endpoint URLs. This bump did not change the OpenAPI document. A fetch or parse failure still drops the API section.

Intended effect

API docs pages keep loading after the pin bump. Confirm with docs.page.load where page_type is api. The OpenAPI document did not change, so the API share should hold. Absent means that share falls toward zero while other page types still load. The API share may move with crawler traffic.

Signal	Baseline	Rule	Source
API share of docs.page.load	2.6-5.9% of all page loads	Hold in this band. Absent if the share falls below 1% while all loads stay near 18k per 24h.	Sentry org sentry project docs. Recent 24h 1073 API loads of 18318 total, 2026-10-25T20:43:00Z/2026-10-26T20:43:00Z. Prior 24h 473 of 18310, 2026-10-24T20:43:00Z/2026-10-25T20:43:00Z. Query page_type:api environment:production on docs.page.load.

Regression watch

A bad pin 404s old API URLs or serves 5xx on /api/ pageloads. Unfiltered errors that match /api/ spiked to 295 at 2026-10-25T13:00:00Z. Do not use that count. Last 24h /api/ errors were Algolia search fetch failures, not API page render failures.

Signal	Baseline	Rule	Source
API 404 share of API loads	0.63-0.65%	Hold in this band. Detected if the 24h share rises above 2%.	Sentry org sentry project docs. docs.page.not_found query requested_path:api* sentry.environment:production. Recent 24h 7 of 1073 API loads. Prior 24h 3 of 473. Windows 2026-10-25T20:43:00Z/2026-10-26T20:43:00Z and 2026-10-24T20:43:00Z/2026-10-25T20:43:00Z.
/api/ pageload 5xx rate	0%	Hold at 0. Detected if any 5xx appears on this path.	Sentry org sentry project docs. Spans span.op:pageload url.path:/api/* environment:production. 0 of 1190 pageloads in 2026-10-25T20:43:00Z/2026-10-26T20:43:00Z. 0 of 1553 in 2026-10-24T20:43:00Z/2026-10-26T20:43:00Z. Traces sample at 30%.

Not observable

LCP for /api/ pageloads returned no value. The live HTML does not expose the schema SHA. develop-docs does not serve OpenAPI pages, so this pin has no queryable effect there.