Bump API schema to db7a2583

[sentry-api-schema-updater]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
develop-docs	Ready	Preview	Oct 8, 2026 2:11pm UTC
sentry-docs	Ready	Preview	Oct 8, 2026 2:11pm UTC

[github-actions]

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]

The plan checks API reference page loads, API 404s, and client TypeErrors. An issue escalates when API 404s rise or TypeErrors rise.

Rollout complete

Services: sentry-docs.

Plan

What changed

The List AI Conversations API page now documents timeSpan. The response example includes timeSpan as a number. The description no longer uses conversation.duration. Schema SHA db7a2583 must ship on sentry-docs before this is live. develop-docs rebuilds the shared source file. It does not load this OpenAPI schema or render those API pages, so it is omitted from services.

Risk

A bad schema can omit generated API pages or crash the API page renderer. All generated API reference pages share that renderer. The blast radius is the whole API reference tree. Wrong field text can mislead API consumers.

Intended effect

This change only updates generated page text. Sentry has no metric for that text. The changed endpoint had 0 page loads in the sampled 24 hours. intended_effect stays unknown from metrics. Absent is the live page still describing conversation.duration and omitting timeSpan.

Regression watch

A schema or renderer fault would show up on generated API pages first. Watch API page loads, API 404s, and client errors. api/alerts 404s are existing noise. Exclude the 2026-10-04 error spike from the hold band.

Signal	Baseline	Band	Window	Source	Rule
API page loads (docs.page.load, page_type:api)	848 in 24h. 7d daily samples 386 and peak 961	386-961 per day	2026-10-07T14:05:00Z to 2026-10-08T14:05:00Z. 7d 2026-10-01T14:05:00Z to 2026-10-08T14:05:00Z	Sentry sentry/docs	Hold in the 7d band. Escalate if a 24h count falls below 386
Explore API page loads (docs.page.load, api_category:explore)	26 in 24h	zero vs not	2026-10-07T14:05:00Z to 2026-10-08T14:05:00Z	Sentry sentry/docs	Hold above zero. This category includes the changed page
API 404s (docs.page.not_found, requested_path:api*)	27 in 24h. 20 of 27 are api/alerts. 27 / 848 API loads = 3.2%	3.2% 404s per API load	2026-10-07T14:05:00Z to 2026-10-08T14:05:00Z	Sentry sentry/docs	Hold near 3.2%. Escalate if API 404s rise or api/explore 404s appear
Production errors	97 in 24h. TypeError 60. NotFoundError 12. 7d daily 53-205 except 2026-10-04	53-205 per day	24h 2026-10-07T14:05:00Z to 2026-10-08T14:05:00Z. 7d 2026-10-01T14:05:00Z to 2026-10-08T14:05:00Z	Sentry sentry/docs	Hold in 53-205 per day. Escalate if TypeErrors rise from 60 in 24h. Ignore the 11155 spike on 2026-10-04

Not observable

The live page body cannot show timeSpan through Sentry. Pageload traces returned no rows for this project. LCP queries for API pages returned no rows.

[cursor]

Verified in production

• API reference pages still load, and the live page still documents timeSpan.