[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 19, 2026 4:55pm UTC
sentry-docs	Ready	Preview	Oct 19, 2026 4:55pm 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 docs page loads, API docs not-found pages, and API path errors. An issue escalates when not-found pages rise or API path errors rise. The OpenAPI pin has no new page content.

Services: sentry-docs.

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

Plan

What changed

The production build now fetches the OpenAPI file from git SHA 76ed6d40. The OpenAPI document matches the prior pin 2adfc005. API docs pages under /api/ still list the same endpoints. sentry-docs must deploy before this pin is live.

Risk

A bad schema pin would omit API docs pages from the static build. Users would then see not-found pages for those URLs. A render failure would show errors on API docs pages. This pin has the same schema JSON, so shape risk is low. The deploy still rebuilds every API docs page.

Intended effect

This pin has no queryable new behavior. The OpenAPI JSON did not change between the two SHAs. API docs pages do not add or remove endpoints. Do not treat a hold of page loads as confirmation of new content. Record intended effect as unknown.

Regression watch

If the pin dropped pages, not-found pages would rise and page loads would fall. If render broke, API path errors or the /api/ failure rate would rise. Prefer the not-found share over the raw not-found count. Weekday page loads run higher than weekend page loads.

Signal	Baseline	Window	Source	Rule
API docs not-found share	0.4-2.4% of API docs page loads. Last 24h was 14 not-found against 678 loads, or 2.1%. UTC days 13-18 Oct 2026 ran 3-10 not-found against 290-965 loads.	2026-10-12T16:50:57Z to 2026-10-19T16:50:57Z	Sentry project docs. docs.page.not_found with requested_path:api* environment:production. Divide by docs.page.load with page_type:api environment:production.	Hold in 0.4-2.4%. Escalate if the share rises above 2.4%.
API docs page loads	Last 24h 678 loads. Prior 24h about 403 loads. Complete UTC days 13-18 Oct 2026 ran 290-965 loads per day. Weekdays ran 699-965. Weekends ran 290-426.	2026-10-12T16:50:57Z to 2026-10-19T16:50:57Z	Sentry project docs. docs.page.load with page_type:api environment:production.	Hold in 290-965 per UTC day. Escalate if a 24h total falls below 290.
API path errors	Last 24h count 4, or about 0.6% of 678 API docs page loads. Prior 24h was not measured with this query.	2026-10-18T16:50:57Z to 2026-10-19T16:50:57Z	Sentry project docs errors. environment:production (transaction:*/api/* OR http.url:*/api/*) with count().	Hold near 0.6% of API docs page loads. Escalate if the share rises above 1.5%.
/api/ HTTP failure rate	Last 24h failure rate 0 on 125 http.server spans.	2026-10-18T16:50:57Z to 2026-10-19T16:50:57Z	Sentry project docs traces. span.op:http.server url.full:*/api/* sentry.environment:production with failure_rate() and count().	Hold at 0. Escalate if the failure rate leaves 0.

User traces sample at 30 percent. Compare each check to the same hours one day earlier. A Monday deploy should track the weekday load band, not the Sunday mix in the last 24h.

Not observable

The intended new API content is not observable. The schema JSON did not change. Client errors on the catch-all page route are not sliced by API path. The error query only matches transactions or URLs that contain /api/. Pageload span failure rate for /api/ docs pages was not measured.