[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 5:53pm UTC
sentry-docs	Ready	Preview	Oct 27, 2026 5:53pm 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 client errors on API pages. An issue escalates when API 404s rise or API page loads fall while other pages hold. The rendered API schema content did not change.

Monitoring in production

Services: sentry-docs.

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

Plan

What changed

The production build now fetches the OpenAPI document at schema SHA 5bd01cda. That commit did not change openapi-derefed.json. Requests to generated API docs pages should keep the same content. sentry-docs must deploy before this pin is live. develop-docs also rebuilds shared src/ from this commit but does not fetch the schema or serve those pages, so it is omitted from services.

Risk

A failed schema fetch fails the production build and leaves the live pin unchanged. A dropped endpoint slug returns 404 for that page. A broken schema would crash API page render. This bump only changed ownership stats, so content risk is low. Blast radius is the generated API docs pages and the shared page render.

Intended effect

The pin is live when API docs pages keep loading after deploy. The OpenAPI file did not change, so loads should hold. absent looks like API page loads falling while other page types hold.

Signal	Baseline	Window	Source	Rule
API page-load share	757 of 19286 loads, 3.9%	2026-10-26T17:48:00Z to 2026-10-27T17:48:00Z	Sentry project docs, metric docs.page.load, query metric.name:docs.page.load AND page_type:api AND sentry.environment:production over all docs.page.load with environment:production	Hold share in 3.9-5.3%. Count may sit in 720-1030 per 24h.

The earlier 24h in the 48h sample had 1029 API loads. The 7d total was 5028, about 718 per day. Use the share, not the raw count, if site traffic shifts. absent if the share falls below 2% while all page loads hold.

Regression watch

This diff can drop generated slugs or break API page render. Watch 404s on API paths and errors on those URLs. Also watch site-wide errors on the same ship.

Signal	Baseline	Window	Source	Rule
API 404 rate	13 API 404s, 1.7% of 757 API loads. Site-wide 404s were 101.	2026-10-26T17:48:00Z to 2026-10-27T17:48:00Z	Sentry project docs, metric docs.page.not_found, query environment:production requested_path:api*	Hold under 3% of API loads, about 13-20 per 24h. Detected if API 404s jump while API loads fall.
API URL errors	3 events, 0.4% of 757 API loads	2026-10-26T17:48:00Z to 2026-10-27T17:48:00Z	Sentry project docs, errors, query environment:production http.url:*/*api/*	Hold near 0.4% of API loads. Detected if this share rises above 1%.
Site error rate	803 events, 4.2% of 19286 page loads. 7d count was 15222.	2026-10-26T17:48:00Z to 2026-10-27T17:48:00Z	Sentry project docs, errors, query environment:production	Hold near 4% of page loads. Raw counts vary by day. Detected if the rate rises above 6%.
API pageload p95	7.7s in 24h, 7.0s over 7d	2026-10-26T17:48:00Z to 2026-10-27T17:48:00Z and 2026-10-20T17:48:00Z to 2026-10-27T17:48:00Z	Sentry project docs, spans, query span.op:[pageload,navigation] environment:production url.full:*/api/*	Hold in 7.0-7.7s. Detected if p95 rises above 8.5s.

Current API 404s are mostly unknown slugs such as api/prevent and api/openapi.json. A real miss would add 404s for categories that used to load. Transaction name is /:path*?, so do not filter errors by /api/ transaction.

Not observable

No signal shows the OpenAPI body text on the page. The prior 24h count for API URL errors was not sampled. Errors cannot group by api_category because the transaction name is /:path*?. develop-docs has no OpenAPI page signal.