Skip to content

Bump API schema to 2af850c3 - #20281

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

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

Conversation

@sentry-api-schema-updater

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Oct 28, 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 28, 2026 7:40am UTC
sentry-docs Ready Ready Preview Oct 28, 2026 7:40am UTC

Request Review

@sentry-api-schema-updater
sentry-api-schema-updater Bot merged commit 79dc9fc into master Oct 28, 2026
8 of 10 checks passed
@sentry-api-schema-updater
sentry-api-schema-updater Bot deleted the bot/bump-api-schema-to-2af850c3 branch October 28, 2026 07:32
@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 28, 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 28, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks Project API docs pages for the new field. It also checks API page loads, API 404s, and errors on those pages. An issue escalates when the field is missing or when API errors or 404s rise.

Rollout complete

Services: sentry-docs.

Plan

What changed

The docs build now reads OpenAPI schema SHA 2af850c334a6d82597c3423e3f7d65ca483ea4b0. Project API docs pages list a new boolean field named enableNativeSourceServerMapping.
This change is live after a production deploy of sentry-docs. API pages do not render on develop-docs.

Risk

A bad schema can fail the Vercel build. A successful build with bad slugs can 404 existing API pages.
A render error in the API page component can break Project API docs pages. Every API docs page shares this schema parse, so the blast radius is all /api/ docs pages.

Intended effect

The new field must appear on the live Project API docs pages. absent means those pages still load and the field name is missing.
People who reach the changed pages are Project API docs viewers. That group loaded 53-59 times per 24h before ship.

Signal Baseline Rule Window Source
Update a Project page body lists enableNativeSourceServerMapping absent confirmed when the field name is present fetched 2026-10-28T07:33:00Z GET https://docs.sentry.io/api/projects/update-a-project/
Retrieve a Project example JSON lists enableNativeSourceServerMapping absent confirmed when the field name is present fetched 2026-10-28T07:33:00Z GET https://docs.sentry.io/api/projects/retrieve-a-project/

Regression watch

Watch API docs pages first. The schema parse feeds every /api/ page, not only Project pages. Split Project pages from the rest of API traffic.
API 404 counts are small and include guessed paths. A new api/projects 404 is a real break. A single extra error is noise.

Signal Baseline Rule Window Source
API docs error rate 0.26-0.49% of API page loads. Counts were 2 then 4 errors. hold in band. Detected if the rate rises above 0.49%, or errors reach 8 or more in 24h while API page loads hold 2026-10-26T07:33:00Z to 2026-10-27T07:33:00Z was 2 errors / 759 loads. 2026-10-27T07:33:00Z to 2026-10-28T07:33:00Z was 4 errors / 818 loads Sentry org sentry project docs. Errors environment:production AND url:"*/api/*". Divide by docs.page.load with environment:production page_type:api
API docs 404 rate 0.7-2.0% of API attempts. Counts were 5 then 17. api/projects 404s were 0 hold in band. Detected if the rate rises above 2.0%, or requested_path:api/projects leaves 0 2026-10-26T07:33:00Z to 2026-10-27T07:33:00Z was 5 API 404s / 764 attempts. 2026-10-27T07:33:00Z to 2026-10-28T07:33:00Z was 17 API 404s / 835 attempts Sentry org sentry project docs. Metric docs.page.not_found with environment:production. Keep rows whose requested_path starts with api. Divide by those 404s plus docs.page.load page_type:api
API share of page loads 4.0-4.2% of all docs.page.load hold in band. Detected if the share falls below 4.0% while total page loads hold 2026-10-26T07:33:00Z to 2026-10-27T07:33:00Z was 759 / 18819. 2026-10-27T07:33:00Z to 2026-10-28T07:33:00Z was 818 / 19374 Sentry org sentry project docs. Metric docs.page.load environment:production grouped by page_type
Project API share of API page loads 7.0-7.2% of API docs.page.load. Counts were 53 then 59 hold in band. Detected if the share falls below 7.0% while API page loads hold 2026-10-26T07:33:00Z to 2026-10-27T07:33:00Z was 53 / 759. 2026-10-27T07:33:00Z to 2026-10-28T07:33:00Z was 59 / 818 Sentry org sentry project docs. Metric docs.page.load with environment:production page_type:api api_category:projects

If API errors rise, inspect API page component failures and MDX parse of the new field description.
If api/projects 404s appear, the Project endpoint slugs changed.
If API page-load share drops and 404s do not rise, the API pages may fail before paint.

Not observable

none

@cursor

cursor Bot commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

Verified in production

  • Both Project API docs pages still list the new field.

This branch was successfully deployed

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