[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 8:36pm UTC
sentry-docs	Ready	Preview	Oct 21, 2026 8:36pm 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 errors on API pages. An issue escalates when API 404s rise or those page errors rise. New code-mapping endpoint pages should start to record loads.

Services: sentry-docs.

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

Plan

What changed

Requests to the Integrations API docs now include two new endpoint pages. Those pages document listing and creating organization code mappings. The live paths are /api/integrations/list-an-organizations-code-mappings/ and /api/integrations/create-an-organization-code-mapping/.

sentry-docs must deploy before this change is live. The build fetches OpenAPI schema 277e2b1129ac7b38d92c94c030adb42680ea1f1a. develop-docs also rebuilds from src/ and does not serve these API pages.

Risk

A broken schema can drop API pages at build time or render bad endpoint pages. Users then hit 404s on API docs. The Integrations category is the first blast radius. Other API categories share the same page generator.

Intended effect

The new endpoint pages must record page loads. Confirmed means either new endpoint counter rises above 0. Absent means both counters stay at 0 while Integrations API page loads hold.

Signal	Baseline	Rule	Source
New code-mapping endpoint page loads	0 loads in 48h from 2026-10-19T20:31:05Z to 2026-10-21T20:31:05Z	rise above 0	Sentry org sentry project docs. Metric docs.page.load. Query api_endpoint:[list-an-organizations-code-mappings,create-an-organization-code-mapping] environment:production.
Integrations API page loads	20 loads in 48h from 2026-10-19T20:31:05Z to 2026-10-21T20:31:05Z	hold near 20 per 48h. This row decides absent when the new counters stay at 0.	Sentry org sentry project docs. Metric docs.page.load. Query page_type:api api_category:integrations environment:production.

Regression watch

This diff can 404 API docs or break the shared API page renderer. Watch API 404s, API page load share, errors on /api/ URLs, and the Integrations slice.

Signal	Baseline	Rule	Source
API 404 rate	1.4-1.9% of API page loads. Last 24h from 2026-10-20T20:31:05Z to 2026-10-21T20:31:05Z had 11 404s and 788 API loads. Prior 24h from 2026-10-19T20:31:05Z to 2026-10-20T20:31:05Z had 15 404s and 793 API loads.	hold 1.4-1.9%. Escalate if the rate rises above 1.9%.	Sentry org sentry project docs. Metric docs.page.not_found query requested_path:api* environment:production. Denominator is docs.page.load query page_type:api environment:production.
API page load share	4.3-4.7% of all page loads. Last 24h had 788 of 18477 loads. Prior 24h had 793 of 16960 loads.	hold 4.3-4.7%. Escalate if the share falls below 4.3%.	Sentry org sentry project docs. Metric docs.page.load. Numerator query page_type:api environment:production. Denominator query environment:production.
Errors on API URLs	1.3-1.8% of API page loads. Last 24h had 14 errors and 788 API loads. The 48h window from 2026-10-19T20:31:05Z to 2026-10-21T20:31:05Z had 21 errors and 1581 API loads.	hold 1.3-1.8%. Escalate if the rate rises above 1.8%.	Sentry org sentry project docs. Errors query environment:production http.url:*/api/*. Denominator is docs.page.load query page_type:api environment:production. Last 24h used http.url:*api*.
Integrations API page loads	20 loads in 48h from 2026-10-19T20:31:05Z to 2026-10-21T20:31:05Z	hold. Escalate if a matching 48h window falls below 10.	Sentry org sentry project docs. Metric docs.page.load. Query page_type:api api_category:integrations environment:production.

If API 404s rise, inspect requested_path values that start with api. A rise on api/integrations points at this schema bump.

Not observable

No synthetic GET hits the two new URLs. A zero load count after deploy can mean no visitors. The Integrations slice has no same-hours day-earlier split. Only the 48h total of 20 loads was measured.