Skip to content

Bump API schema to dc40ad2b - #20133

Merged
sentry-api-schema-updater[bot] merged 1 commit into
masterfrom
bot/bump-api-schema-to-dc40ad2b
Oct 21, 2026
Merged

sentry-api-schema-updater[bot] merged 1 commit into
masterfrom
bot/bump-api-schema-to-dc40ad2b

Conversation

@sentry-api-schema-updater

Copy link
Copy Markdown
Contributor

No description provided.

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 636057c into master Oct 21, 2026
13 of 15 checks passed
@vercel

vercel Bot commented Oct 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
develop-docs Building Building Preview Oct 21, 2026 12:48pm UTC
sentry-docs Building Building Preview Oct 21, 2026 12:48pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-dc40ad2b branch October 21, 2026 12:48
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

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

cursor Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks the Start Seer Issue Fix scopes list, API 404s, and API-page errors. An issue escalates when API 404s or API-page errors rise above the measured band.

Services: sentry-docs.

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

Plan

What changed

The Start Seer Issue Fix API docs page lists seer:write as an allowed auth token scope. This is live after a sentry-docs production deploy. OpenAPI pages are not rendered on develop-docs. The Vercel report workflow maps Production sentry-docs to this service.

Risk

A malformed OpenAPI security block can crash the Scopes list on generated API pages. A slug rewrite can 404 bookmarked API docs pages. This patch only adds one scope string. A slug rewrite is unlikely. Blast radius is generated API reference pages. The Seer category has more weight.

Intended effect

The Scopes list on Start Seer Issue Fix must include seer:write. Absent means the list still shows only event:admin and event:write.

Signal Baseline Rule Source
seer:write on the Scopes list absent on 2026-10-21T12:49:00Z seer:write must be present after deploy GET https://docs.sentry.io/api/seer/start-seer-issue-fix/

Regression watch

This schema bump is baked in at build time. A bad render can 404 or throw on generated API pages. Watch API 404s, API-page errors, all API page loads, and Seer API page loads.

Signal Baseline Rule Source
API 404 share 1.4-1.9% of API-path outcomes. 15 API 404s and 785 API loads in 2026-10-20T12:49:00Z to 2026-10-21T12:49:00Z. 12 API 404s and 817 API loads in 2026-10-19T12:49:00Z to 2026-10-20T12:49:00Z. hold in 1.4-1.9% Sentry org sentry, project docs, production. docs.page.not_found with environment:production requested_path:api*. Divide by that count plus docs.page.load with page_type:api environment:production.
API-page error share 1.0-1.3% of API page loads. 8 errors in 2026-10-20T12:49:00Z to 2026-10-21T12:49:00Z. 10 errors in 2026-10-19T12:49:00Z to 2026-10-20T12:49:00Z. hold in 1.0-1.3% Sentry org sentry, project docs, production. Errors with environment:production (http.url:*/api/* OR transaction:*/api/*). Divide by docs.page.load with page_type:api environment:production.
API page-load share 4.5-4.9% of all page loads. 785 of 17289 in 2026-10-20T12:49:00Z to 2026-10-21T12:49:00Z. 817 of 16790 in 2026-10-19T12:49:00Z to 2026-10-20T12:49:00Z. hold in 4.5-4.9% Sentry org sentry, project docs, production. docs.page.load with page_type:api environment:production over docs.page.load with environment:production.
Seer API page-load share 1.2-2.2% of API page loads. 17 of 785 in 2026-10-20T12:49:00Z to 2026-10-21T12:49:00Z. 10 of 817 in 2026-10-19T12:49:00Z to 2026-10-20T12:49:00Z. hold in 1.2-2.2% Sentry org sentry, project docs, production. docs.page.load with environment:production page_type:api api_category:seer over docs.page.load with page_type:api environment:production.

Seer volume is low. The share may move inside this wide band. Do not treat Algolia fetch failures as this change. Do not treat browser-extension CustomElementRegistry errors as this change.

Not observable

Sentry pageload spans for API paths returned zero rows. Transaction names use a catch-all route, so API latency is not split. LCP with page_type api returned no value. The permissions MDX page is not updated by this schema bump.

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — b82ad088 Deployed Oct 21, 2026 by vercel[bot]
Preview – develop-docs — b82ad088 Deployed Oct 21, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Needs Triage The PR description is missing valid priority information

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants