Skip to content

feat(api): Badge experimental endpoints on API reference pages - #19320

Draft
DominikB2014 wants to merge 1 commit into
masterfrom
dominikbuszowiecki/feat/api-experimental-badge
Draft

feat(api): Badge experimental endpoints on API reference pages#19320
DominikB2014 wants to merge 1 commit into
masterfrom
dominikbuszowiecki/feat/api-experimental-badge

Conversation

@DominikB2014

Copy link
Copy Markdown
Contributor

Sentry publishes some endpoints under a new PUBLIC_EXPERIMENTAL status (getsentry/sentry#123914), which stamps x-sentry-experimental: true on the operation in openapi-derefed.json. Nothing here read it — the operation type only modelled tag-level x- extensions — so those endpoints rendered as though they were stable. This models the extension, carries it onto the API type next to the existing deprecated flag, and renders a badge above the request block. Until this lands, Sentry prepends a text notice to the description as a fallback; that can be dropped once the badge ships.

Sentry marks endpoints published under the PUBLIC_EXPERIMENTAL status with
x-sentry-experimental on the operation, but nothing read it, so those endpoints
rendered as though they were stable.

Model the extension, carry it onto the API type next to the existing deprecated
flag, and render a badge above the request block.
@vercel

vercel Bot commented Sep 9, 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 Sep 9, 2026 4:26pm UTC
sentry-docs Ready Ready Preview Sep 9, 2026 4:26pm UTC

Request Review

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.

1 participant