Skip to content

Bump API schema to 81f843cd - #20176

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

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

Conversation

@sentry-api-schema-updater

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Oct 22, 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 22, 2026 12:58pm UTC
sentry-docs Ready Ready Preview Oct 22, 2026 12:58pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit d7c8715 into master Oct 22, 2026
1 of 3 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-81f843cd branch October 22, 2026 12:51
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 22, 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 22, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks API page loads, API 404s, and error events on those pages. An issue escalates when API 404s rise or those error events increase.

Rollout complete

Services: sentry-docs, develop-docs.

Plan

What changed

API reference pages now build from OpenAPI schema 81f843cd. GitHub compare shows no OpenAPI JSON change from pin 4973d6c8. Endpoint pages likely match the prior pin.

sentry-docs must deploy before the new pin is live. develop-docs also ships this commit from the same repo. develop-docs does not render these API reference pages.

Risk

A bad schema pin can omit API pages or rename endpoint slugs. Readers then see 404s on former API URLs. A fetch failure at build time blocks the sentry-docs deploy. The shared resolver module also ships on develop-docs.

Intended effect

API pages generated from the schema keep loading. Confirm this on Sentry project docs. Do not use project develop-docs for this signal. After a develop-docs-only deploy, mark intended effect unknown.

The schema JSON did not change. Do not expect new pages. Absent looks like the API load share falling toward 0 while all page loads hold.

Last 24h API loads were 852 of 18682. Prior 24h API loads were 786 of 17310. About 398 of the 852 API loads lack api_category and are MDX, not schema pages. Escalate if a named api_category slice falls to 0 while total API loads hold.

Signal Band Window Source Rule
docs.page.load share with page_type:api 4.5-4.6% of all docs.page.load 2026-10-20T12:52Z to 2026-10-22T12:52Z Sentry sentry/docs, environment:production, sum(docs.page.load) hold this share

Regression watch

A wrong pin 404s former API URLs first. The catch-all page imports the resolver, so a module failure can raise errors on all docs pages. develop-docs ships the same module.

Existing API 404s already concentrate on api/alerts, api/organizations, and api/events. Treat a rise above the measured share as a regression. Do not treat those existing 404s as new.

Signal Band Window Source Rule
docs.page.not_found share with requested_path:api* 1.9% of API docs.page.load 2026-10-21T12:52Z to 2026-10-22T12:52Z Sentry sentry/docs, environment:production, sum(docs.page.not_found) vs sum(docs.page.load page_type:api) hold near this share
error events with http.url:/api/ 0.94-1.02% of API docs.page.load 2026-10-20T12:52Z to 2026-10-22T12:52Z Sentry sentry/docs, environment:production, count() hold this band
docs error events 1.20-1.29% of all docs.page.load 2026-10-20T12:52Z to 2026-10-22T12:52Z Sentry sentry/docs, environment:production, count() vs sum(docs.page.load) hold this band
develop-docs error events 1.69-1.75% of develop-docs docs.page.load 2026-10-20T12:52Z to 2026-10-22T12:52Z Sentry sentry/develop-docs, environment:production, count() vs sum(docs.page.load) hold this band

Last 24h API 404s were 16 against 852 API page loads. Last 24h API-URL errors were 8. Prior 24h API-URL errors were 8 against 786 API page loads. Last 24h docs errors were 241 against 18682 page loads. Prior 24h docs errors were 207 against 17310 page loads. Last 24h develop-docs errors were 32 against 1892 page loads. Prior 24h develop-docs errors were 29 against 1655 page loads.

Not observable

The prior-day count for docs.page.not_found on api paths did not return. That 404 share uses one 24h window only. Pageload traces with transaction:/api/* returned 0, so this plan does not use span failure rate for API pages.

@cursor

cursor Bot commented Oct 22, 2026

Copy link
Copy Markdown
Contributor

Verified in production

  • API schema pages still load, and 404s and API errors did not rise.

This branch was successfully deployed

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