[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 21, 2026 5:24pm UTC
sentry-docs	Ready	Preview	Oct 21, 2026 5:24pm 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-page 404s, and client errors on those pages. An issue escalates when API-page 404s or client errors rise.

Rollout complete

Services: sentry-docs.

Plan

What changed

API reference pages now render OpenAPI schema 82d40817. The query parameter text on two Explore Events pages now states a 16-regex limit. The pages are Query Explore Events in Table Format and Query Explore Events in Timeseries Format. sentry-docs must deploy before this is live.

Risk

Those two pages parse parameter text as Markdown. A bad parse can fail the page render. Other API pages share the same static generator. This pin does not change path slugs. A render fault would show as client errors or 404s on /api/ paths.

Intended effect

The two Explore Events pages must show the new 16-regex sentence in the query parameter. Sentry does not store page copy. Telemetry cannot confirm this effect. Absent looks like the old query text without the 16-regex sentence.

Regression watch

This pin can break Markdown render on the two Explore Events pages. It can also fail other /api/ pages that use the same generator. Traces are sampled at 30 percent. Error events are not sampled the same way. Treat the error ratio as a relative index.

Signal	Baseline	Window	Rule	Source
Client errors on /api/ URLs	8-15 events per 24h. Latest 24h is 15. Prior 24h is 8. Ratio to sampled /api/ pageloads is 1.2-2.0%. Explore URLs had 0 errors.	2026-10-19T17:17:00Z to 2026-10-21T17:17:00Z	Hold the count in 8-15 and the ratio in 1.2-2.0%. Hold Explore errors at 0. Escalate if the count rises above 15 or Explore errors appear.	Sentry project docs. Query: environment:production AND (url:"*/api/*" OR transaction:"*/api/*") with count(). Split with url:"*/api/explore/*".
API-page 404s	8-13 docs.page.not_found events per 24h for paths that start with api. Latest 24h is 13. Prior 24h is 8. api/explore is 0. Latest 24h is mostly api/alerts.	2026-10-19T17:17:00Z to 2026-10-21T17:17:00Z	Hold overall API 404s in 8-13. Hold api/explore at 0. Escalate if api/explore 404s appear or overall API 404s rise above 13.	Sentry project docs. Query: metric.name:docs.page.not_found AND requested_path:api* AND sentry.environment:production with sum(value) grouped by requested_path.
Sampled /api/ pageload and navigation volume	654-743 spans per 24h. Latest 24h is 743. Prior 24h is 654. Explore path latest 24h is 20. Table Format URL latest 24h is 13. Timeseries Format URL latest 24h is 0.	2026-10-19T17:17:00Z to 2026-10-21T17:17:00Z	Hold overall volume in 654-743. Escalate if overall volume falls below 654.	Sentry project docs. Query: span.op:[pageload,navigation] AND url.full:"*/api/*" AND sentry.environment:production with count().
Sampled /api/ pageload p95 duration	5040-5180ms. Latest 24h p95 is 5041ms. 48h pooled p95 is 5180ms. Explore path latest 24h p95 is 6251ms on 20 spans.	2026-10-19T17:17:00Z to 2026-10-21T17:17:00Z	Hold overall p95 in 5040-5180ms. Escalate if overall p95 rises above 5180ms.	Sentry project docs. Query: span.op:[pageload,navigation] AND url.full:"*/api/*" AND sentry.environment:production with p95(span.duration).

Client docs.page.load with page_type:api was 781 in the latest 24h. Use that count as the unsampled denominator when the span count moves with sampling.

Not observable

Page copy on the two Explore Events URLs is not in Sentry. The executor cannot fill intended effect from telemetry. The Timeseries Format page had zero sampled pageloads in the latest 24h. The prior-day docs.page.load total for page_type:api was not retrieved.