Bump API schema to c86df12d

[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	Building	Preview	Oct 8, 2026 4:42pm UTC
sentry-docs	Ready	Preview	Oct 8, 2026 4:42pm 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, missing API pages, and production errors. An issue escalates when API page loads fall. It also escalates when API 404s or error events rise.

Services: sentry-docs, develop-docs.

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

Plan

What changed

Public API reference pages rebuild from schema pin c86df12. The pinned schema commit does not change the dereferenced OpenAPI document. API page content must match the prior pin. sentry-docs must deploy before those pages are live. develop-docs also ships this shared source file. develop-docs does not generate API reference pages from the schema.

Risk

A failed schema fetch or parse can omit API pages at build time. Users then see missing API pages after deploy. A schema shape the renderer cannot handle can throw on API pages. The shared source import can also break the develop-docs build. Content drift is low because the OpenAPI document did not change.

Intended effect

API pages must keep loading at the prior share of traffic. This pin adds no new OpenAPI paths. Absent looks like API page loads near zero while other page loads hold.

Signal	Baseline	Rule	Source
API page loads	895 loads in 24h. Share is 4.5% of 20092 total loads. Hourly count is 4-92. Overnight hours sit near the floor. Peak hours reach the top of the band.	Hold the share near 4.5% and the hourly count in 4-92. Confirmed if API loads continue in that band. Absent if the share falls toward 0% while total loads stay near 20092 per 24h.	Sentry org sentry, project docs. Query metric.name:docs.page.load AND page_type:api AND environment:production. Window 2026-10-07T16:34:00Z to 2026-10-08T16:34:00Z.

Regression watch

A bad pin can drop generated API routes. Watch missing API pages and production errors on both ships.

Signal	Baseline	Rule	Source
API 404s	25 counts in 24h. Ratio is 2.8% of 895 API page loads. Hourly count is 0-1 on most hours. One hour reached 19.	Hold the 404-to-load ratio near 2.8%. Detected if the ratio rises well above 2.8% while API loads hold, or if hourly 404s stay above 1 besides a single spike.	Sentry org sentry, project docs. Query metric.name:docs.page.not_found AND requested_path:api* AND environment:production. Window 2026-10-07T16:34:00Z to 2026-10-08T16:34:00Z.
Production error events	102 events in 24h. Rate is 0.51% of 20092 page loads. Hourly count is 0-14.	Hold the rate near 0.51% and the hourly count in 0-14. Detected if the rate rises well above 0.51% or hourly counts stay above 14.	Sentry org sentry, project docs. Query environment:production on error events. Window 2026-10-07T16:34:00Z to 2026-10-08T16:34:00Z.
develop-docs production error events	26 events in 24h. Hourly count is 0-9.	Hold the hourly count in 0-9. Detected if hourly counts stay above 9.	Sentry org sentry, project develop-docs. Query environment:production on error events. Window 2026-10-07T16:34:00Z to 2026-10-08T16:34:00Z.

If API 404s rise, inspect generated /api/ routes for missing categories. If error events rise, inspect API page render failures.

Not observable

The rendered endpoint text is not in telemetry. The ownership-stats file in the schema repo is not served. This pin does not add a new metric.