[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 5:23pm UTC
sentry-docs	Ready	Preview	Oct 26, 2026 5:23pm 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 and not-found counts. An issue escalates when API page loads collapse or not-found counts rise. Rendered API reference content is expected to stay the same.

Services: sentry-docs, develop-docs.

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

Plan

What changed

The docs build fetches the public API schema from git SHA b5335bf4. API reference pages must keep the same OpenAPI document as SHA 46e6baad. The JSON blob hash did not change. sentry-docs must deploy before the new fetch SHA is live. develop-docs also ships this shared source file. develop-docs does not fetch or render the OpenAPI schema.

Risk

A failed schema fetch fails the production docs build. A parse error drops API endpoint pages from the static path list. Users then see not-found responses for those endpoints. A new tag slug can replace an existing API guide page.

Intended effect

API reference pages must keep loading after the rebuild. The OpenAPI body did not change. Absent means API page loads fall far below the band while other docs traffic continues.

Signal	Baseline	Window	Rule	Source
docs.page.load	20-43 loads/h. 1018 counts in the last 24h. 472 counts in the prior 24h. 5063 counts in 7d.	2026-10-25T17:17Z to 2026-10-26T17:17Z. Prior 24h starts 2026-10-24T17:17Z. 7d starts 2026-10-19T17:17Z.	Hold inside the band. Monday sat at the top. Weekend sat at the bottom. Absent if the rate falls far below 20/h.	Sentry org sentry project docs. environment:production page_type:api.

Regression watch

This change can drop generated API endpoint pages. Those misses show up as not-found events. If not-found volume rises, group by requested_path and inspect api paths.

Signal	Baseline	Window	Rule	Source
docs.page.not_found	1.9-2.7 counts/h. 65 counts in the last 24h. 45 counts in the prior 24h.	2026-10-25T17:17Z to 2026-10-26T17:17Z. Prior 24h starts 2026-10-24T17:17Z.	Hold inside the band. Escalate if the 24h rate rises above 2.7/h.	Sentry org sentry project docs. environment:production.

The 24h not-found top paths included api/events at 2 counts. That path was the only api path in the top 10.

Not observable

Pageload p95 and span count for /api/ paths. Sentry trace search timed out twice.
Client errors cannot be sliced to /api/ pages. All production errors use transaction /:path*?. Fleet error volume is unstable. The last 24h had 875 events. The prior 24h had about 12090 events.
Total not-found for all api paths. Only api/events appeared in the 24h top 10. Sixteen of 65 events sat on unlisted paths.
Wrong OpenAPI body text. The JSON blob matches the previous SHA. Pages are not scraped.
develop-docs has no OpenAPI runtime signal.