Skip to content

Bump API schema to 786d404c - #20184

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

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

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 5:31pm UTC
sentry-docs Ready Ready Preview Oct 22, 2026 5:31pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 28742a6 into master Oct 22, 2026
14 of 16 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-786d404c branch October 22, 2026 17:23
@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 client errors on API pages. An issue escalates when API page loads fall 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 category and endpoint pages now build from schema SHA 786d404c. The compare did not list a change to the OpenAPI file. sentry-docs must deploy before those pages go live. develop-docs also ships the shared source on the same commit. develop-docs does not render API reference pages. The runtime Sentry project tag is docs, not the catalog id.

Risk

A bad schema can rename or drop endpoint slugs. Users then get 404s on old API page URLs. A fetch or parse failure fails the docs build. A render defect can throw client errors on API pages. The blast radius is the API reference section.

Intended effect

API pages stay reachable after the pin. The OpenAPI file itself did not change operations. absent looks like API page loads falling far below the band while other pages still load.

Signal Baseline Rule Source
docs.page.load with page_type:api 866 loads in 2026-10-21T17:24:17Z to 2026-10-22T17:24:17Z. 781 loads in 2026-10-20T17:24:17Z to 2026-10-21T17:24:17Z. Band 781-866 loads per 24h. Share of all page loads is 866/18608, which is 4.7%, in the latest 24h. Hold in 781-866 loads per 24h. Sentry org sentry project docs environment production. Metric docs.page.load. Query page_type:api environment:production. Aggregate sum(value).

Regression watch

Watch 404s and client errors on API URLs. A slug change would raise 404s first. A render break would raise client errors on those URLs.

Signal Baseline Rule Source
docs.page.not_found with requested_path:api* 20 in 2026-10-21T17:24:17Z to 2026-10-22T17:24:17Z, which is 20/866 or 2.3% of API page loads. 13 in 2026-10-20T17:24:17Z to 2026-10-21T17:24:17Z, which is 13/781 or 1.7%. Band 1.7-2.3% of API page loads. Hold in 1.7-2.3% of API page loads. Escalate if the share rises above 2.3%. Sentry org sentry project docs environment production. Metric docs.page.not_found. Query requested_path:api* environment:production. Aggregate sum(value).
Client errors on URLs that contain /api/ 5 events in 2026-10-21T17:24:17Z to 2026-10-22T17:24:17Z, which is 5/866 or 0.58% of API page loads. 15 events in 2026-10-20T17:24:17Z to 2026-10-21T17:24:17Z, which is 15/781 or 1.9%. Band 0.58-1.9% of API page loads. All 5 latest events share title Event Event captured as promise rejection. Hold in 0.58-1.9% of API page loads. Escalate if the share rises above 1.9%. Sentry org sentry project docs environment production. Dataset errors. Query environment:production AND url:"*/api/*". Aggregate count().

Not observable

Pageload latency and LCP for API pages. The trace query timed out. Warning logs for missing MDX at runtime. The log query timed out. Prior 24h API page loads by api_category. Only the latest 24h by category exists. 48h count of all page loads. The 4.7% share uses the latest 24h only.

This branch was successfully deployed

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