Skip to content

Bump API schema to 48eb3714 - #20009

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

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

Conversation

@sentry-api-schema-updater

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Oct 15, 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 15, 2026 8:43pm UTC
sentry-docs Ready Ready Preview Oct 15, 2026 8:43pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 5612a13 into master Oct 15, 2026
0 of 2 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-48eb3714 branch October 15, 2026 20:39
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 15, 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 15, 2026 •

Copy link
Copy Markdown
Contributor

API documentation pages should keep loading with the same content after this schema commit update. The plan checks API page loads, missing API pages, and errors on those pages. An issue escalates when API pages vanish or those errors rise.

Services: sentry-docs.

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

Plan

What changed

The documentation build fetches OpenAPI schema 48eb3714 instead of b03c02fb. The GitHub compare listed only CHANGELOG.md and package.json. The OpenAPI JSON file did not change in those commits. Generated API documentation pages should keep the same routes. sentry-docs must deploy before this change is live. The catalog id matches the Vercel project and the production deploy reporter.

Risk

A bad schema can omit API routes from the static build. Users then see 404 pages for former endpoint URLs. A schema parse failure at build blocks the whole site deploy. A render failure can throw on API documentation pages. Other documentation sections do not fetch this schema at request time.

Intended effect

The rebuild still serves schema-derived API documentation pages. The schema JSON did not change, so load volume should hold. Absent looks like API page loads falling toward zero while other page types hold.

Signal Baseline Rule Source
API page loads 0.54-0.63 per minute. Share of all page loads 4.2-4.6%. Last 24h was 913 loads. Prior 24h was 781 loads. Windows 2026-10-13T20:39:57Z to 2026-10-15T20:39:57Z. Hold in that band. Sentry org sentry, project docs. Metric docs.page.load. Filter page_type:api environment:production. Compare to all docs.page.load with environment:production.

Regression watch

A slug change would 404 former endpoint URLs. A render break would raise errors on those pages. Heavier pages would raise API page latency. User traces sample at 30 percent. Compare p95, not count. The p95 windows overlap, so that band is approximate. Last 24h API errors were Kapa and Algolia client fetch failures.

Signal Baseline Rule Source
API 404 share 0.4-1.4% of API page loads. Last 24h had 4 misses. Prior 24h had 11 misses. Windows 2026-10-13T20:39:57Z to 2026-10-15T20:39:57Z. Stay at or below 1.4%. Sentry org sentry, project docs. Metric docs.page.not_found. Filter requested_path:api* environment:production. Divide by docs.page.load with page_type:api.
API page error rate 0.22-0.51% of API page loads. Last 24h had 2 errors. Prior 24h had 4 errors. Windows 2026-10-13T20:39:57Z to 2026-10-15T20:39:57Z. Stay at or below 0.51%. New exception titles also escalate. Sentry org sentry, project docs. Errors with http.url:/api/ environment:production. Divide by docs.page.load with page_type:api.
API page p95 duration 4.9-5.1 seconds for pageload and navigation spans. Last 24h p95 was 4.9s. 48h p95 was 5.1s. Windows 2026-10-13T20:39:57Z to 2026-10-15T20:39:57Z. Stay at or below 5.1 seconds. Sentry org sentry, project docs. Spans with span.op:[pageload,navigation] url.path:/api/* environment:production. Field p95(span.duration).

Not observable

The live site does not emit the schema commit, so the new pin is not directly visible. Whether rendered endpoint text matches schema 48eb3714 is not instrumented. Build-time fetch failures never reach production telemetry.

This branch was successfully deployed

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