[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 14, 2026 7:33am UTC
sentry-docs	Building	Preview	Oct 14, 2026 7:33am 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 build now pins a newer API schema. Generated API pages pick up that schema. The conversation endpoint page shows new stats notes. An issue escalates when API page loads fall or API 404s rise.

Services: sentry-docs, develop-docs.

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

Plan

What changed

Requests to /api/explore/retrieve-an-organizations-ai-conversation/ now say stats return on the first page only. The stats object in that response schema is now nullable. No route slug changed.

sentry-docs must deploy before those pages are live. develop-docs also deploys the shared app from this commit. develop-docs does not generate the OpenAPI pages. Catalog path match plus the Vercel deploy report both name these two services.

Risk

A bad schema can drop generated API pages. Readers then see 404 pages under /api/. A render break can raise client errors on API pages. The blast radius is the API reference. The Explore category is the first path to watch. The shared app also ships to develop-docs.

Intended effect

The new description text is not in telemetry. Use API page loads as the proxy that the schema still builds pages. Absent: the API share of page loads falls below 4.1% while all page loads hold. The conversation page itself had 0 loads in the last 24h and 2 loads in 7d, so it cannot confirm the text change.

Signal	Baseline	Window	Rule	Source
docs.page.load share with page_type:api	4.32% prior 24h (799/18479). 4.68% last 24h (937/20028). 4.08% over 7d (5183/127079). Band 4.1-4.7%.	2026-10-12T07:34:27Z to 2026-10-14T07:34:27Z and 2026-10-07T07:34:27Z to 2026-10-14T07:34:27Z	Hold in 4.1-4.7% of all docs.page.load	Sentry org sentry, project docs. Sum docs.page.load with page_type:api environment:production, divided by sum of all docs.page.load in production.
docs.page.load with api_category:explore	32 prior 24h. 9 last 24h. 7d mean 21 per 24h. Volume is low and varied.	2026-10-12T07:34:27Z to 2026-10-14T07:34:27Z and 2026-10-07T07:34:27Z to 2026-10-14T07:34:27Z	Hold above 0. Use only with the API share row. A zero here plus an API share drop is absent.	Sentry org sentry, project docs. Sum docs.page.load with api_category:explore environment:production.

Regression watch

This diff can 404 generated API pages or throw in the API page client. Watch API 404s first. Watch production errors on the same ship.

Signal	Baseline	Window	Rule	Source
docs.page.not_found with requested_path:api* as a share of API docs.page.load	1.00% prior 24h (8/799). 0.85% last 24h (8/937). 1.56% over 7d (81/5183). Band 0.85-1.6%.	2026-10-12T07:34:27Z to 2026-10-14T07:34:27Z and 2026-10-07T07:34:27Z to 2026-10-14T07:34:27Z	Hold at or below 1.6%. Rise above the band is detected.	Sentry org sentry, project docs. Sum docs.page.not_found with environment:production requested_path:api*, divided by sum of docs.page.load with page_type:api environment:production.
Production error events as a share of all docs.page.load	1.10% prior 24h (203/18479). 0.82% last 24h (164/20028). Band 0.82-1.10%.	2026-10-12T07:34:27Z to 2026-10-14T07:34:27Z	Hold in 0.82-1.10%. Rise above the band is detected.	Sentry org sentry, project docs. Count error events with environment:production, divided by sum of docs.page.load in production.
docs.page.not_found with requested_path:api/explore	2 counts in the last 24h. Explore loads were 9 in that window.	2026-10-13T07:34:27Z to 2026-10-14T07:34:27Z	Do not treat a small count rise alone as detected. Pair with the API 404 share. A jump to a large share of Explore loads is detected.	Sentry org sentry, project docs. Sum docs.page.not_found with environment:production requested_path:api/explore.

If the API 404 share rises, inspect /api/explore/ first. Then inspect other /api/ category pages.

Not observable

The new first-page stats sentence is not in telemetry. The nullable stats flag is not in telemetry. Client pageload traces keyed by URL /api/explore/retrieve-an-organizations-ai-conversation/ returned 0 spans, so URL-named traces cannot decide this change. Conversation page loads are too sparse to confirm the page. develop-docs has no page-load denominator in this plan, so its error counts cannot form a rate.