[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 23, 2026 10:05pm UTC
sentry-docs	Ready	Preview	Oct 23, 2026 10:05pm 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 reference page loads, missing API paths, and client TypeErrors. An issue escalates when API page loads fall or missing API paths rise. Other docs page loads must hold.

Rollout complete

Services: sentry-docs, develop-docs.

Plan

What changed

API reference pages now build from OpenAPI schema 6d0a2152. The OpenAPI JSON did not change from the prior SHA. Users must still see the same API pages. sentry-docs must deploy before the new SHA is live. develop-docs also rebuilds this commit from the same tree. That site does not generate API pages. develop-docs is listed because src/ ships in both Vercel projects.

Risk

A failed schema fetch can fail the production build. A slug change can return not-found for API pages. A parameter shape change can crash API page render. Those failures stay on the API reference path. The same deploy also ships every other docs page.

Intended effect

API pages must keep loading at the measured share of all page loads. The OpenAPI JSON is unchanged, so the share must hold. Absent looks like a drop in the API share while other page types hold.

Query metric.name:docs.page.load AND sentry.environment:production, group by page_type, and take count. Use Sentry org sentry and project docs.

Signal	Baseline	Window	Source	Rule
docs.page.load share for page_type=api	4.3-5.3% of all docs.page.load	2026-10-16T22:00:12Z to 2026-10-23T22:00:12Z and 2026-10-22T22:00:12Z to 2026-10-23T22:00:12Z	Sentry org sentry, project docs, production	Hold in the band. 7d was 4748 of 110030. 24h was 847 of 16161.

Regression watch

A slug or render break on API pages shows as not-found events or TypeErrors. Sibling platforms pages show whether the whole deploy is broken.

Signal	Baseline	Window	Source	Rule
docs.page.not_found rate on requested_path api* versus API page loads	1.2-1.6%	2026-10-16T22:00:12Z to 2026-10-23T22:00:12Z and 2026-10-22T22:00:12Z to 2026-10-23T22:00:12Z	Sentry org sentry, project docs, production. Query metric.name:docs.page.not_found AND sentry.environment:production AND requested_path:api*	Hold in the band. 7d was 76 not-found against 4748 API loads. 24h was 10 against 847. Rise above the band is a regression.
TypeError rate versus docs.page.load	0.28-0.39%	2026-10-16T22:00:12Z to 2026-10-23T22:00:12Z and 2026-10-22T22:00:12Z to 2026-10-23T22:00:12Z	Sentry org sentry, project docs, production. Query error.type:TypeError AND environment:production	Hold in the band. 7d was 430 TypeErrors against 110030 loads. 24h was 45 against 16161. Rise above the band is a regression.
docs.page.load share for page_type=platforms	51-55% of all docs.page.load	2026-10-16T22:00:12Z to 2026-10-23T22:00:12Z and 2026-10-22T22:00:12Z to 2026-10-23T22:00:12Z	Sentry org sentry, project docs, production	Hold in the band. 7d was 59857 of 110030. 24h was 8340 of 16161. A drop with the API share means a wider deploy break.
develop-docs TypeError rate versus docs.page.load	1.15-1.24%	2026-10-16T22:00:12Z to 2026-10-23T22:00:12Z and 2026-10-22T22:00:12Z to 2026-10-23T22:00:12Z	Sentry org sentry, project develop-docs, production	Hold in the band. 7d was 129 TypeErrors against 10419 loads. 24h was 19 against 1658. Rise above the band is a regression on the shared src/ ship.

Not observable

Telemetry cannot read the HTML of query-parameter types on API pages. That gap does not hide a new content shift because the OpenAPI JSON did not change. Pageload transactions use /:path*?, so TypeErrors cannot be sliced to /api/ URLs. Use the API not-found signal for path-level failures.