Skip to content

Bump API schema to 537966de - #20007

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

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

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 6:40pm UTC
sentry-docs Ready Ready Preview Oct 15, 2026 6:40pm UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit caef8cf into master Oct 15, 2026
13 of 15 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-537966de branch October 15, 2026 18:35
@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

The change rebuilds API reference pages from a newer schema pin. The schema file itself did not change. Watch API page loads, API 404s, and API page errors. An issue escalates when API 404s or API page errors rise.

Services: sentry-docs, develop-docs.

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

Plan

What changed

The build now fetches OpenAPI from GitHub commit 537966de. The prior pin was 8da67f72. The OpenAPI JSON did not change between those commits. API reference pages keep the same content. sentry-docs must deploy before the pin is live. develop-docs also ships this shared source file. API pages render only on sentry-docs.

Risk

A bad schema pin can drop API pages or render broken endpoint pages. Readers then see 404s or client errors on API reference paths. A rebuild of the shared source can also break develop-docs. This pin does not change OpenAPI content. The remaining risk is a failed fetch or a bad static deploy.

Intended effect

API reference pages must keep loading after the pin. The OpenAPI JSON is unchanged, so page-load volume should hold. Absent looks like this: API page loads fall while other page loads hold.

Signal Baseline Rule Source
API page load docs.page.load 846 last 24h from 2026-10-14T18:36:07Z to 2026-10-15T18:36:07Z. 856 in the prior 24h from 2026-10-13T18:36:07Z to 2026-10-14T18:36:07Z. 1702 of 38479 total page loads over 48h, a 4.4% share Hold in 840-870 per 24h. Keep the share near 4.2-4.6% of all docs.page.load Sentry org sentry, project docs. Query page_type:api environment:production. Aggregate sum(value, docs.page.load, counter, none)

Regression watch

This pin can still 404 API paths if static generation drops them. It can also ship client errors on those pages. develop-docs can break from the shared rebuild.

Signal Baseline Rule Source
API 404 docs.page.not_found 15 counts from 2026-10-13T18:36:07Z to 2026-10-15T18:36:07Z against 1702 API page loads, 0.88% Hold at or below 1.2% of API page loads Sentry org sentry, project docs. Query environment:production (requested_path:api OR requested_path:api/*). Aggregate sum(value, docs.page.not_found, counter, none)
API page error 6 events in that same 48h, 0.35% of API page loads Hold at or below 0.6% of API page loads Sentry org sentry, project docs. Query environment:production (http.url:*/api/* OR message:*ApiPage*). Aggregate count()
API 5xx pageload 0 sampled pageload and navigation spans with status 500 or higher in that same 48h Hold at 0 Sentry org sentry, project docs. Query span.op:[pageload,navigation] url.path:/api/* http.status_code:>=500 environment:production. Aggregate count()
develop-docs production error 59 events from 2026-10-13T18:36:07Z to 2026-10-15T18:36:07Z Hold in 50-70 per 48h Sentry org sentry, project develop-docs. Query environment:production. Aggregate count()

Not observable

Page copy at field level has no metric. The 24h API pageload p95 split timed out. The 48h p95 was 5065ms on 1560 sampled pageload and navigation spans. Build-time GitHub fetch of the schema has no production metric.

This branch was successfully deployed

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