[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	Building	Preview	Oct 21, 2026 5:20pm UTC
sentry-docs	Building	Preview	Oct 21, 2026 5:20pm 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 production errors. An issue escalates when API 404s rise or production errors rise.

Services: sentry-docs, develop-docs.

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

Plan

What changed

API reference pages rebuild from schema SHA 35fcbf58. The OpenAPI document matches the previous pin. Endpoint pages stay the same.

sentry-docs must deploy before the new pin is live. develop-docs also deploys this commit from the shared source tree. The OpenAPI fetch runs only during the sentry-docs build.

Risk

A missing or invalid schema file fails the sentry-docs build. API pages then 404. A slug change would 404 old API URLs. This pin does not change schema JSON, so slug churn is unlikely. The shared page module could break the develop-docs build if init fetched the schema. Current code does not fetch it there.

Intended effect

API pages keep loading after the rebuild. The API load share should hold. Absent looks like the API load share near zero while API 404s rise. This pin adds no new endpoint pages.

Signal	Baseline	Rule	Source
API page-load share	4.6% of all page loads in 2026-10-20T17:20:00Z to 2026-10-21T17:20:00Z. 4.8% in 2026-10-19T17:20:00Z to 2026-10-20T17:20:00Z. Counts were 780 and 800 API loads against 16973 and 16803 total loads.	Hold the share in 4.6-4.8%.	Sentry org sentry, project docs. metric.name:docs.page.load AND page_type:api AND sentry.environment:production over metric.name:docs.page.load AND environment:production.

Regression watch

A bad pin can drop API pages or raise errors on the docs site.

Signal	Baseline	Rule	Source
API 404 rate	1.6% of API URL hits in 2026-10-20T17:20:00Z to 2026-10-21T17:20:00Z. 1.0% in 2026-10-19T17:20:00Z to 2026-10-20T17:20:00Z. Counts were 13 and 8 API 404s against 793 and 808 API URL hits.	Hold in 1.0-1.6%.	Sentry org sentry, project docs. metric.name:docs.page.not_found AND requested_path:api* AND sentry.environment:production over API loads plus those 404s.
Docs error rate	1.6% of page loads in 2026-10-20T17:20:00Z to 2026-10-21T17:20:00Z. 0.9% in 2026-10-19T17:20:00Z to 2026-10-20T17:20:00Z. Counts were 264 and 155 errors against 16973 and 16803 page loads.	Hold in 0.9-1.6%.	Sentry org sentry, project docs. Errors environment:production over metric.name:docs.page.load AND environment:production.
develop-docs errors	33 errors in 2026-10-20T17:20:00Z to 2026-10-21T17:20:00Z. 30 errors in 2026-10-19T17:20:00Z to 2026-10-20T17:20:00Z. Last window had 1801 page loads, or 1.8% errors.	Hold 30-33 errors per 24h.	Sentry org sentry, project develop-docs. Errors environment:production.

Not observable

Production does not emit the schema SHA. Per-endpoint page text has no telemetry. Pageload p95 for API pages had no usable trace query. develop-docs page-load volume for the prior 24h was not measured. Last 24h had 15 docs errors on /api/ URLs. The prior 24h for that slice was not measured.