[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 6:11pm UTC
sentry-docs	Ready	Preview	Oct 27, 2026 6:11pm 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, API 404s, and page-load failures on those pages. An issue escalates when API pages stop loading or those 404s rise. It also checks page-load time on API reference pages.

Rollout complete

Services: sentry-docs.

Plan

What changed

API reference pages now build from OpenAPI schema SHA fe8bd6fa8b6c90500c7c05645712ed8ac8147764. That schema commit did not change openapi-derefed.json. Rendered API pages should stay the same. The sentry-docs ship must deploy before this pin is live. The develop-docs ship compiles this file but does not fetch the schema. That is why develop-docs is not in services.

Risk

A missing or invalid schema file fails the production build. A dropped API path then returns 404. A schema field that ApiPage cannot render throws on that page. The blast radius is the API reference section. Other pages do not read this pin.

Intended effect

OpenAPI-backed API pages keep loading at the current share of all page loads. Hold that share in the measured band. Absent looks like those loads fall toward zero while other page loads continue.

Signal	Baseline	Window	Source	Rule
OpenAPI API page-load share	2.1-2.5% of all docs.page.load	2026-10-26T18:05:00Z to 2026-10-27T18:05:00Z and 2026-10-20T18:05:00Z to 2026-10-27T18:05:00Z	Sentry org sentry project docs. Counter docs.page.load with sentry.environment:production. OpenAPI rows use page_type:api and api_category:*. All rows use the same metric with no page_type filter. 24h OpenAPI loads were 403 of 19365. 7d OpenAPI loads were 2880 of 117041.	Hold in 2.1-2.5%. Absent if the share falls below 1% while all page loads stay near 16700-19400 per day.

Hourly OpenAPI-inclusive API loads ranged from 7 to 93 in that 24h window. Compare on the 24h share. Do not compare one hour to another hour.

Regression watch

This pin can drop API paths or break ApiPage render. Watch 404s and page-load failures on API URLs. Put each risk on these checks.

Signal	Baseline	Window	Source	Rule
API 404 rate	1.4-1.7% of API page loads	2026-10-26T18:05:00Z to 2026-10-27T18:05:00Z and 2026-10-20T18:05:00Z to 2026-10-27T18:05:00Z	Sentry org sentry project docs. Counter docs.page.not_found with sentry.environment:production and requested_path:api* over counter docs.page.load with page_type:api. 24h was 13 404s over 760 API loads. 7d was 69 404s over 5022 API loads.	Stay in or below 1.4-1.7%. Detected if the rate rises above 2.5%.
API page-load failure rate	2.6-8.3%	2026-10-26T18:05:00Z to 2026-10-27T18:05:00Z and 2026-10-20T18:05:00Z to 2026-10-27T18:05:00Z	Sentry org sentry project docs. Spans span.op:[pageload,navigation] environment:production url.full:*docs.sentry.io/api*. 24h failure_rate() was 0.026 on 663 spans. 7d failure_rate() was 0.083 on 5103 spans.	Stay in 2.6-8.3%. The 7d rate is higher than the last 24h. The rate may be bursty. Detected if the rate rises above 8.3%.
API page-load p95	7010-7670ms	2026-10-26T18:05:00Z to 2026-10-27T18:05:00Z and 2026-10-20T18:05:00Z to 2026-10-27T18:05:00Z	Same span query as the failure rate. 24h p95(span.duration) was 7667ms. 7d p95(span.duration) was 7013ms.	Hold in 7010-7670ms. Detected if p95 rises above 7670ms.

Not observable

Build-time fetch of the schema has no runtime metric. A miss fails the Vercel build. This session did not compare rendered HTML to the prior pin. Client errors on API URLs in the last 24h were three third-party fetch failures. Those errors are not a schema signal.

[cursor]

Verified in production

• Generated API pages kept loading after this ship, and API 404s did not rise.