[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 16, 2026 8:13pm UTC
sentry-docs	Ready	Preview	Oct 16, 2026 8:13pm 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, API page latency, and errors on those pages. An issue escalates when API page load share falls or those errors rise.

Rollout complete

Services: sentry-docs, develop-docs.

Plan

What changed

The production build fetches the OpenAPI document from commit de3e9904. That document matches the prior pin 7fb093da. API reference pages keep the same paths and the same content.

sentry-docs and develop-docs must deploy before this commit is live. Only the sentry-docs build generates API reference pages from the schema. develop-docs ships the same source file and does not generate those pages. The Vercel deploy workflow reports both services.

Risk

A failed schema fetch fails the sentry-docs build. A bad static generate would drop API pages or break their render. Removed endpoint slugs would 404. This SHA does not change the schema file.

Intended effect

This pin does not add a new page or a new metric. The OpenAPI file is unchanged between the two SHAs. There is no queryable intended effect. Production telemetry cannot show confirmed or absent for the pin.

Regression watch

A missing generate would cut API page load share and raise API 404s. A broken API page would raise errors on API URLs and pageload time.

Current API page errors are third-party fetch failures from Algolia and Kapa. Hourly pageload p95 is noisy and often 0 when volume is low. Use pooled 24h values. Share may move with weekday traffic mix.

If the error rate rises, check error titles for ApiPage or schema parse failures.

Signal	Baseline	Window	Source	Rule
API page load share	4.6-4.8% of all page loads	2026-10-14T20:08Z to 2026-10-16T20:08Z	Sentry org sentry, project docs. Metric docs.page.load with environment:production. API rows use page_type:api. Last 24h 769 of 15940. Prior 24h 903 of 19764.	Hold in the band. A fall below 4.6% may mean API pages are missing.
API 404 rate	0.4-1.0% of API page loads	2026-10-14T20:08Z to 2026-10-16T20:08Z	Sentry org sentry, project docs. Metric docs.page.not_found with requested_path:api* and environment:production. Last 24h 8 of 769. Prior 24h 4 of 903. A few API 404s already occur. Most are under api/alerts.	Hold or stay under 1.0%. A rise above 1.0% is a regression.
API page error rate	0.2-0.4% of API page loads	2026-10-14T20:08Z to 2026-10-16T20:08Z	Sentry org sentry, project docs. Errors with environment:production url:*/api/*. Last 24h 3 of 769. Prior 24h 2 of 903.	Hold in the band. A rise above 0.4% or new ApiPage titles is a regression.
API pageload p95	8.0-9.8s	2026-10-14T20:08Z to 2026-10-16T20:08Z	Sentry org sentry, project docs. Traces span.op:pageload url.full:*docs.sentry.io/api/* environment:production. Last 24h p95 9795ms. 48h p95 8014ms. Traces are sampled at 30%.	Hold in the band. A rise above 9.8s is a regression.

Not observable

The pinned SHA is not emitted at runtime. develop-docs has no OpenAPI page signal. Build-time GitHub fetch success is not in Sentry.