[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 27, 2026 9:47pm UTC
sentry-docs	Ready	Preview	Oct 27, 2026 9:47pm 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, API 404s, and client errors on those pages. An issue escalates when API page loads fall or those 404s or errors rise. The SCHEMA tab on dropped-events pages should show a new suppressedDrops field.

Monitoring in production

Services: sentry-docs.

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

Plan

What changed

API reference pages rebuild from OpenAPI schema 9f048abe. The SCHEMA tab on dropped-events pages then lists required suppressedDrops next to droppedEvents.

sentry-docs must deploy to production before this is live. Vercel also builds develop-docs from this SHA. That site does not generate API schema pages.

Risk

A broken schema can omit API pages from the static build. Readers then get 404s under /api/. A SCHEMA tab render fault can throw client errors on dropped-events pages. Other API pages share the same build.

Intended effect

The new behavior is suppressedDrops in the SCHEMA JSON on dropped-events API pages. Sentry has no metric for that text. absent means the SCHEMA tab still omits suppressedDrops after the production deploy.

Page loads for api_endpoint query-dropped-and-accepted-events-stats-by-outcome-and-reason cannot confirm the field. That volume is too low.

Signal	Baseline	Window	Source	Rule
docs.page.load for api_endpoint query-dropped-and-accepted-events-stats-by-outcome-and-reason	2 loads in 48h	2026-10-25T21:42:00Z to 2026-10-27T21:42:00Z	Sentry org sentry project docs, metric docs.page.load, query environment:production api_endpoint:dropped	A load after deploy only shows the page is reachable. Zero loads is not absent.

Regression watch

This schema rebuild can 404 API pages or throw on the SCHEMA tab. Watch all API reference pages, not only dropped-events. The rate may vary by day.

Signal	Baseline	Window	Source	Rule
docs.page.load page_type:api	802 loads last 24h. 1068 loads prior 24h. Band 800-1070 per 24h.	last 24h 2026-10-26T21:42:00Z to 2026-10-27T21:42:00Z. prior 24h 2026-10-25T21:42:00Z to 2026-10-26T21:42:00Z	Sentry org sentry project docs, metric docs.page.load, query environment:production page_type:api	Hold inside 800-1070 per 24h. Escalate if the 24h total falls below 800.
docs.page.load page_type:api api_category:explore	18 loads last 24h	2026-10-26T21:42:00Z to 2026-10-27T21:42:00Z	Sentry org sentry project docs, metric docs.page.load, query environment:production page_type:api api_category:explore	Hold near 18 per 24h on this slice. Escalate if this slice falls while the fleet total holds.
docs.page.not_found requested_path:api*	10 loads last 24h. api/explore was 1.	2026-10-26T21:42:00Z to 2026-10-27T21:42:00Z	Sentry org sentry project docs, metric docs.page.not_found, query environment:production requested_path:api*	Hold near 10 per 24h. Escalate if api/explore 404s exceed 1 per 24h.
error events with http.url /api/	3 events last 24h. 2 events prior 24h. Rate 0.37% then 0.19% of API page loads. Band 0.2-0.4%.	last 24h 2026-10-26T21:42:00Z to 2026-10-27T21:42:00Z. prior 24h 2026-10-25T21:42:00Z to 2026-10-26T21:42:00Z	Sentry org sentry project docs, errors query environment:production http.url:/api/	Hold 0.2-0.4% of API page loads. Escalate on a new error title on API pages.

These error counts are small. Last 24h titles were Algolia and shopimgs fetch failures. A new TypeError on API pages is a regression even if the rate stays in band.

Not observable

Sentry does not record SCHEMA tab text. The executor cannot confirm suppressedDrops from metrics.

Pageload and navigation spans for transaction /api/ returned no rows. API page latency is unknown.

The prior 24h count for api_category explore page loads was not measured. The prior 24h count for API 404s was not measured.