Skip to content

Bump API schema to 80b62b7f - #19846

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

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

Conversation

@sentry-api-schema-updater

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
develop-docs Ready Ready Preview Oct 7, 2026 8:02pm UTC
sentry-docs Ready Ready Preview Oct 7, 2026 8:02pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 14afec4 into master Oct 7, 2026
12 of 14 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-80b62b7f branch October 7, 2026 19:54
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 7, 2026
@github-actions

github-actions Bot commented Oct 7, 2026

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 7, 2026 •

Copy link
Copy Markdown
Contributor

This change rebuilds API reference pages from a new OpenAPI schema. The plan uses API page loads, API 404s, and client errors on those pages as signals. An issue escalates when API page loads drop or those 404s and errors rise.

Services: sentry-docs, develop-docs.

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

Plan

What changed

API reference pages now build from OpenAPI schema 80b62b7f. That schema only changes the Vercel installation source_url. The docs renderer does not read source_url. Page text may stay the same. sentry-docs must deploy before the new schema is live. develop-docs also ships the shared src file. develop-docs does not generate these API pages.

Risk

A bad schema can fail the docs build or drop API pages. Users then see 404s or client errors on API reference paths. This SHA changes one unused field. The blast radius may stay small. A parse failure would still hit every API reference page.

Intended effect

Telemetry cannot show that pages now use schema 80b62b7f. Use API page loads as the proxy that rebuilt API pages are served. absent looks like docs.page.load with page_type:api near zero while other page_type values still load.

Signal Baseline Window Source Comparison
docs.page.load with page_type:api and environment:production 824 loads per 24h 2026-10-06T19:54:55Z to 2026-10-07T19:54:55Z Sentry org sentry, project docs Hold near 824 per 24h. Treat a drop toward 0 as absent.
docs.page.load with page_type:platforms and environment:production 8896 loads per 24h 2026-10-06T19:54:55Z to 2026-10-07T19:54:55Z Sentry org sentry, project docs Confirms other docs pages still load. Do not use a drop here as the API effect.

Regression watch

This schema rebuild can drop API routes or break API page render. Watch 404s on API paths and client errors on those pages. Search and chat fetch errors are already in the API error baseline. Do not treat those alone as a schema failure.

Signal Baseline Window Source Comparison
docs.page.not_found with requested_path:api/alerts and environment:production 6 per 24h 2026-10-06T19:54:55Z to 2026-10-07T19:54:55Z Sentry org sentry, project docs Hold near 6 per 24h. Rise above this band is detected.
docs.page.not_found with environment:production 101 per 24h 2026-10-06T19:54:55Z to 2026-10-07T19:54:55Z Sentry org sentry, project docs Hold near 101 per 24h. Rise above this band is detected.
Production errors with http.url:*/api/* 11 errors vs 824 API loads, 1.3% 2026-10-06T19:54:55Z to 2026-10-07T19:54:55Z Sentry org sentry, project docs Hold at or below 1.3%. Rise above this rate is detected.
Production errors on project docs 143-144 per 24h 2026-10-06T19:54:55Z to 2026-10-07T19:54:55Z Sentry org sentry, project docs Hold in 143-144 per 24h. Rise above this band is detected.

If API 404s rise, inspect missing category or endpoint slugs from the new schema. If API errors rise beyond Algolia and Kapa fetch noise, inspect API page render.

Not observable

The live page does not expose schema SHA 80b62b7f. The renderer has no source_url field, so the Vercel URL change is not visible. Pageload spans with transaction:/api/* returned 0 samples. Do not use that trace query.

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — c6f21512 Deployed Oct 7, 2026 by vercel[bot]
Preview – develop-docs — c6f21512 Deployed Oct 7, 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