[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:58pm UTC
sentry-docs	Building	Preview	Oct 21, 2026 8:58pm 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 loads of the new bulk code-mappings API page. It also checks API reference page loads, API 404s, and errors on API URLs. An issue escalates when API 404s or API URL errors rise.

Services: sentry-docs.

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

Plan

What changed

The public API reference now documents bulk create or update of organization code mappings. Requests to /api/integrations/create-or-update-organization-code-mappings-in-bulk/ now return that endpoint page. Existing Integrations API pages stay. sentry-docs must deploy before this page is live. develop-docs also builds this commit. That site does not fetch the schema and does not serve these pages.

Risk

A bad schema can fail the production build. Then the new page never ships. A render bug on the new page can throw client errors. A missing static path can 404 the new URL. Existing API pages can 404 if the build drops them. The new request body uses anyOf for project. The page renderer may not handle that field.

Intended effect

The change worked when docs.page.load with api_endpoint create-or-update-organization-code-mappings-in-bulk rises above zero. That counter is new. Its pre-deploy value is zero. Absent looks like that counter stays at zero. Other API page loads can still hold. A new docs URL can stay at zero if nobody opens it. Compare it to Integrations API page loads. Those were 6-14 per 24h.

Signal	Baseline	Rule	Window	Source
docs.page.load with api_endpoint:create-or-update-organization-code-mappings-in-bulk	0 loads per 24h	rise above 0	2026-10-20T20:55Z to 2026-10-21T20:55Z	Sentry metrics, org sentry, project docs, environment:production api_endpoint:create-or-update-organization-code-mappings-in-bulk, sum(value, docs.page.load, counter, none)

Regression watch

This diff can break API reference pages. Watch 404s and errors on /api/ URLs. Also watch API page load volume. Watch Integrations 404s as the slice this page joins.

Signal	Baseline	Rule	Window	Source
API 404 rate. docs.page.not_found with requested_path:api* over docs.page.load with page_type:api	1.8-1.9% (14/770 and 15/805 per 24h)	hold in 1.8-1.9%	2026-10-19T20:55Z to 2026-10-20T20:55Z and 2026-10-20T20:55Z to 2026-10-21T20:55Z	Sentry metrics, org sentry, project docs. 404s: environment:production requested_path:api*, sum(value, docs.page.not_found, counter, none). Loads: environment:production page_type:api, sum(value, docs.page.load, counter, none)
Errors on /api/ URLs over API page loads	0.9-1.8% (7/805 and 14/770 per 24h)	hold in 0.9-1.8%	2026-10-19T20:55Z to 2026-10-20T20:55Z and 2026-10-20T20:55Z to 2026-10-21T20:55Z	Sentry errors, org sentry, project docs, environment:production project:docs (transaction:*/api/* OR http.url:*/api/*), count(). Denominator is docs.page.load with page_type:api
docs.page.load with page_type:api	770-805 loads per 24h	hold in 770-805 per 24h	2026-10-19T20:55Z to 2026-10-20T20:55Z and 2026-10-20T20:55Z to 2026-10-21T20:55Z	Sentry metrics, org sentry, project docs, environment:production page_type:api, sum(value, docs.page.load, counter, none)
Integrations 404s. docs.page.not_found with requested_path:api/integrations	0-1 per 24h	hold in 0-1 per 24h	2026-10-19T20:55Z to 2026-10-20T20:55Z and 2026-10-20T20:55Z to 2026-10-21T20:55Z	Sentry metrics, org sentry, project docs, environment:production requested_path:api/integrations, sum(value, docs.page.not_found, counter, none)

Integrations URL errors stayed at 0 for 48h. Treat a rise above 0 as a fault. Query Sentry errors with environment:production project:docs (transaction:*/api/integrations* OR http.url:*/api/integrations*).

Not observable

Pageload and navigation spans for /api/integrations returned 0 in 24h. Trace sampling is 30 percent. Sidebar clicks are soft navigations. Do not use traces for this path. Metrics do not show whether the new page body is correct.