Bump API schema to 7644b769

[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 7, 2026 10:52pm UTC
sentry-docs	Ready	Preview	Oct 7, 2026 10:52pm 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 change rebuilds API reference pages from a new schema pin. Those pages did not gain new endpoints. The plan checks API page loads, API not-found counts, and client errors on API pages. An issue escalates when API page loads fall or API not-found counts rise.

Rollout complete

Services: sentry-docs, develop-docs.

Plan

What changed

The docs build now fetches OpenAPI from git SHA 7644b769d158f83bc0079e77566bf6247f1c6c0c. Requests to /api/ category and endpoint pages still render from openapi-derefed.json. That OpenAPI file did not change in this schema revision. Only api_ownership_stats_dont_modify.json changed. sentry-docs and develop-docs must deploy this commit. They share src/.

Risk

A bad schema JSON can fail the Vercel build for both sites. A later shape change can drop API pages or return not-found for old slugs. This revision does not change the consumed OpenAPI file, so content risk is low. Fetch failure at build still remains.

Intended effect

This pin does not add new API pages. Confirm that existing /api/ pages still load after the rebuild. absent means docs.page.load with page_type:api stays near zero while other docs pages still load.

Signal	Baseline	Window	Rule	Source
API page loads (docs.page.load, page_type:api)	829 counts per 24h	2026-10-06T22:46:40Z to 2026-10-07T22:46:40Z	Hold near 829. absent if the count falls near zero while other pages still load.	Sentry org sentry project docs. Metrics: page_type:api environment:production sum(value, docs.page.load)
/api/ pageload and navigation share	733 of 18410 spans, 4.0%. 7d mean is about 683 per day	24h as above. 7d: 2026-09-30T22:46:40Z to 2026-10-07T22:46:40Z (4780 spans)	Hold the 24h count in 683-733 and the share near 4.0%. absent if /api/ spans collapse while all pageloads stay near 18410.	Sentry org sentry project docs. Spans: span.op:[pageload,navigation] url.path:/api/* environment:production. All-path query omits url.path. Traces are sampled at 30%.

Regression watch

A broken schema can 404 old /api/ slugs, raise client errors on those pages, or ship a bad build through shared src/.

Signal	Baseline	Window	Rule	Source
API not-found (docs.page.not_found, requested_path starts with api)	13 counts per 24h. 99 sitewide not-found. api/alerts is 6 of the 13	2026-10-06T22:46:40Z to 2026-10-07T22:46:40Z	Hold near 13. detected if API not-found rises while API page loads fall.	Sentry org sentry project docs. Metrics: sentry.environment:production requested_path:api* sum(value, docs.page.not_found)
Client errors on /api/ pages	7 events per 24h, about 1.0% of 733 sampled /api/ spans. Titles are TypeError: Failed to fetch (insights.algolia.io) (4), TypeError: Failed to fetch (proxy.kapa.ai) (2), and one Event promise rejection	same 24h	Hold near 7 events and those fetch titles. detected if a new error type appears or the count rises above this band.	Sentry org sentry project docs. Errors: environment:production http.url:*/api/*
Docs production errors	132 events per 24h	same 24h	Hold near 132. detected if this count rises with API not-found or API-page errors.	Sentry org sentry project docs. Errors: environment:production count()
Develop-docs production errors	30 events per 24h. /api/ pageload and navigation count is 0	same 24h	Hold near 30. detected if this count rises after the shared src/ deploy.	Sentry org sentry project develop-docs. Errors: environment:production count()

Not observable

The live page does not expose the schema SHA, so the executor cannot prove the pin is 7644b769. OpenAPI prose accuracy is not in telemetry. Vercel build fetch of GitHub is not connected here. Daily min-max for /api/ span counts is not available. The 7-day error total did not match the 24h rate, so it is unused.

[cursor]

Verified in production

• API pages load on this ship and not-found counts and client errors stayed normal.