Skip to content

Bump API schema to e07d44d7 - #20185

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

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

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

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 7138fcf into master Oct 22, 2026
15 of 17 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-e07d44d7 branch October 22, 2026 17:25
@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 Replay list and retrieve docs pages now include two new field names. The plan checks Replay API page loads, API 404s, and API page errors. An issue escalates when API 404s or API page errors rise.

Services: sentry-docs.

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

Plan

What changed

The docs build fetches OpenAPI schema e07d44d7 and rebuilds API pages from it.
The Replay list and retrieve pages add field choices ota_updates and replay_type.
Those pages keep the same URLs.
sentry-docs must deploy before the new field list is live.
The catalog says src changes also ship to develop-docs.
This file does not run on developer docs, so only sentry-docs serves these pages.

Risk

A bad schema can fail the production build or drop API pages from the static path list.
Readers then see 404s on API docs pages.
All API pages share one schema fetch, so damage can reach every API docs page.
The new enum values only change the field choices list on two Replay pages.
That list render fails only if the page cannot map the extra strings.

Intended effect

The intended effect is the new field names on those two Replay API pages.
Sentry does not record that page text.
The executor cannot confirm or reject the new names from telemetry.
Record intended_effect as unknown from these signals.
Replay API page loads only show that those pages still render. Use that row under Regression watch.

Regression watch

A bad schema can 404 API pages or throw during API page render.
Use API 404s and API page errors as the symptom signals.
Replay API page loads falling with rising 404s means the pages dropped.
Last 24h API 404s already sit at the top of the band.

Signal Baseline Rule Source
Replay API page loads 13-41 counts per 24h hold in the band Sentry org sentry project docs. Counter docs.page.load. Query page_type:api api_category:replays. Last 24h 41 from 2026-10-21T17:26:37Z to 2026-10-22T17:26:37Z. Prior 24h 13 from 2026-10-20T17:26:37Z to 2026-10-21T17:26:37Z.
API 404s 7-20 counts per 24h stay at or below the band Sentry org sentry project docs. Counter docs.page.not_found. Query requested_path:api*. Last 24h 20 from 2026-10-21T17:26:37Z to 2026-10-22T17:26:37Z. Prior 24h 7 from 2026-10-20T17:26:37Z to 2026-10-21T17:26:37Z.
API page errors 5-15 events per 24h stay at or below the band Sentry org sentry project docs. Errors query environment:production http.url:/api/. Last 24h 5 from 2026-10-21T17:26:37Z to 2026-10-22T17:26:37Z. Prior 24h 15 from 2026-10-20T17:26:37Z to 2026-10-21T17:26:37Z.

Replay API pages get little traffic, so the load counter can stay quiet for hours.
If API 404s rise, inspect missing /api/ slugs and the OpenAPI fetch during the build.

Not observable

The field choices text on the two Replay API pages is not in telemetry.
All API page-load volume did not return in time.
API 404 and API error shares of that volume are therefore missing.
Pageload p95 for Replay API URLs has one 2d pool of 835ms and no 24h split, so it is not a band.

This branch was successfully deployed

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