[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 2:16pm UTC
sentry-docs	Ready	Preview	Oct 26, 2026 2:16pm 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 on API pages. An issue escalates when API page loads collapse or those 404s and errors rise. Pageload time on API paths is the fourth signal.

Rollout complete

Services: sentry-docs, develop-docs.

Plan

What changed

The API reference build now fetches OpenAPI schema 06f4a0f2. The schema repository diff for this pin changes only the changelog and package version. API page content is likely unchanged.

sentry-docs must deploy before the API reference is live. develop-docs also ships this shared source file. develop-docs does not render API reference pages. The pick follows the Vercel production deploy map and the catalog claim that a src/ change ships to both.

Risk

A bad schema can fail the docs build or drop endpoint pages. Dropped or renamed endpoints then 404 on old API URLs. A render fault throws in the browser on API pages. The shared file also ships with developer docs, which do not serve these pages.

Intended effect

API pages keep loading after the rebuild. Content should not shift. absent means API page loads fall near zero while other page types still load.

Signal	Baseline	Window	Source	Rule
docs.page.load with page_type:api	456-887 counts per 24h. Last 24h 887. Prior 24h 456.	2026-10-24T14:11:07Z to 2026-10-26T14:11:07Z	Sentry org sentry project docs. Query page_type:api environment:production. Field sum(value, docs.page.load, counter, none).	Hold inside the band. No shift is expected. absent is a drop toward 0 while other page_type values still load.

Last 24h category mix on this signal was led by events at 105 and crons at 94. A null api_category bucket of 329 is the /api/ index page.

Regression watch

This pin can 404 old endpoint URLs or throw on API pages. Watch 404s, client errors, and pageload time on /api/ paths.

Signal	Baseline	Window	Source	Rule
API 404 rate. docs.page.not_found with requested_path:api* over docs.page.load with page_type:api	0.45%-1.10%. Last 24h 4/887. Prior 24h 5/456.	2026-10-24T14:11:07Z to 2026-10-26T14:11:07Z	Sentry org sentry project docs. 404 query environment:production requested_path:api*. Field sum(value, docs.page.not_found, counter, none). Load query as in Intended effect.	Rise above the band is a regression.
API page client error rate. Errors with http.url:docs.sentry.io/api/ excluding title Event captured as promise rejection, over docs.page.load with page_type:api	0.23%-0.44%. Last 24h 2/887. Prior 24h 2/456.	2026-10-24T14:11:07Z to 2026-10-26T14:11:07Z	Sentry org sentry project docs. Query environment:production http.url:*docs.sentry.io/api/*. Field count() by title.	Rise above the band is a regression. New TypeError titles on these URLs also count.
API path pageload p95. span.op:pageload and url.path:/api/*	7833-8212ms. Last 24h p95 8212ms on 1107 spans. 48h p95 7833ms on 1473 spans.	2026-10-24T14:11:07Z to 2026-10-26T14:11:07Z	Sentry org sentry project docs. Query span.op:pageload url.path:/api/* environment:production. Fields count(), p95(span.duration).	Rise above the band is a regression.

Do not treat title Event captured as promise rejection as a new regression. It fired 296 times in the prior 24h and zero times in the last 24h.

Not observable

The live site does not expose which schema SHA it was built from. API page-load mix by api_category was not measured for 2026-10-24T14:11:07Z to 2026-10-25T14:11:07Z. develop-docs has no API page-load signal because it does not render these pages. develop-docs production error rate has no measured page-load denominator.

[cursor]

Verified in production

• API pages kept loading on the new build, and 404s and client errors did not rise.