[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:08pm UTC
sentry-docs	Ready	Preview	Oct 16, 2026 8:08pm 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 those client errors rise.

Rollout complete

Services: sentry-docs, develop-docs.

Plan

What changed

API reference pages now build from OpenAPI schema commit 54bf83fc.
That commit only retags schema 0.360.0. The OpenAPI file matches pin 7e86985c.
Generated /api/ category and endpoint pages must keep the same paths.
sentry-docs must deploy before those pages are live.
develop-docs also deploys this shared src change. It does not render OpenAPI pages.

Risk

A bad schema can drop or rename generated API routes. Old links then 404.
A render fault can throw client errors on the remaining API pages.
The shared src import can also fail develop-docs after this ship.

Intended effect

The pin is a build-time input. Telemetry cannot show the SHA.
The schema file did not change, so API page loads must hold after the rebuild.
absent looks like API page loads near zero while other page types hold.

Signal	Baseline	Window	Rule	Source
API page loads docs.page.load with page_type:api	774 loads. Share 4.9% of 15954 page loads. Prior 23h count 889.	2026-10-15T20:03:00Z to 2026-10-16T20:03:00Z. Prior 2026-10-14T21:00:00Z to 2026-10-15T20:03:00Z.	Hold the 24h share in 4.4-5.6%. Hold the 24h count in 770-890.	Sentry org sentry, project docs. Query metric.name:docs.page.load environment:production grouped by page_type.

Regression watch

A dropped or renamed endpoint shows up as an API 404. A render break shows up as a client error on an API page.
Hourly docs errors spiked to 71-72 at 2026-10-15T02:00:00Z and 2026-10-15T10:00:00Z. Treat those spikes as known noise.

Signal	Baseline	Window	Rule	Source
API 404s docs.page.not_found with requested_path:api*	8 counts. Share 1.0% of 774 API page loads. Split: api/alerts 5, api/projects 1, api/discover 1, api/guides 1. Site 404s 55.	2026-10-15T20:03:00Z to 2026-10-16T20:03:00Z	Stay at or below 2.0% of API page loads.	Sentry org sentry, project docs. Query metric.name:docs.page.not_found environment:production requested_path:api*.
Client errors on API pages	3 events. Share 0.39% of 774 API page loads.	2026-10-15T20:03:00Z to 2026-10-16T20:03:00Z	Stay at or below 1.0% of API page loads.	Sentry org sentry, project docs. Query environment:production AND (url:"*/api/*" OR transaction:"*/api/*").
Docs production errors	104 events. Share 0.65% of 15954 page loads. Split: TypeError 55, Event 47, UnhandledRejection 2. Prior 23h count 263.	2026-10-15T20:03:00Z to 2026-10-16T20:03:00Z. Prior 2026-10-14T21:00:00Z to 2026-10-15T20:03:00Z.	Stay in 0.65-1.7% of page loads.	Sentry org sentry, project docs. Query environment:production on error events, count() by error.type.
develop-docs production errors	23 events. Prior 23h count 32.	2026-10-15T20:03:00Z to 2026-10-16T20:03:00Z. Prior 2026-10-14T21:00:00Z to 2026-10-15T20:03:00Z.	Hold the 24h count in 20-35.	Sentry org sentry, project develop-docs. Query environment:production on error events, count().

Not observable

The schema SHA is not a runtime metric. Confirm the pin from the deploy, not from Sentry.
API page HTML is not in telemetry. A silent copy change would not show.
Prior-day API 404s and prior-day API-page errors were not measured.
Pageload p95 for /api/ spans swung from 0 ms to 14083 ms. That band cannot rule a regression.