POST /releases/{release}/quality-report/refresh

Re-run the Preflight QC analysis for a held release

Editing a held release no longer re-runs the automated checks — it only marks the report stale. Call this endpoint to explicitly start a fresh analysis cycle once you have finished editing: the checks re-run, the release.preflight.report_ready webhook fires when they complete, and the report's stale flag clears.

The call is idempotent while a cycle is already running: it returns the in-progress state without queuing a second analysis (and without spending budget). A per-release hourly budget applies to cycles actually started — exceeding it returns 429 preflight_recheck_limit_reached with a Retry-After header.

Conflict responses: 409 not_in_customer_review_hold (the release is not awaiting your review), 409 refresh_coalesced (an analysis just completed moments ago — retry after the Retry-After seconds). The release must pass validation first (403 RELEASE_NOT_VALIDATED), and Preflight QC must be enabled for the owning account (403 pre_review_qc_not_enabled).

Parameters

Responses