Sign in
Practice Review Backfill

Confirm or cancel a backfill campaign

RUNNING authorises the estimated spend and starts the campaign; CANCELLED stops it for good.

patch/workspaces/{workspaceSlug}/practices/backfill-runs/{runId}/status

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /workspaces/{workspaceSlug}/practices/backfill-runs/{runId}/status
  • Auth: HTTP bearer

Path parameters

workspaceSlugstring required

Workspace slug

runIdstring uuid required

Request body

status'RUNNING' | 'CANCELLED' required

RUNNING confirms the estimate and starts the campaign; CANCELLED stops it for good

Response

Campaign updated

artifactKindstring required
confirmedByAccountIdinteger

Who authorised the spend; absent until the run is confirmed

createdAtstring date-time required
discoveredVia'EVENT' | 'SYNC' | 'MANUAL' | 'BACKFILL' | 'SWEEP' required

BACKFILL for a campaign an admin scoped by hand, SWEEP for one a recurring schedule opened

estimatedArtifactsinteger required
estimatedCostUsdnumber

Forecast total spend in USD; absent when the workspace has no priced review history

failedCountinteger required

artifacts whose submission threw, leaving no job and no recorded decision. Non-zero means this campaign's baseline has holes in it, which is why it is reported apart from a pass.

finishedAtstring date-time
fromAtstring date-time required
idstring uuid required
passedCountinteger required

artifacts walked past without one: already measured at their current state, or refused by the review gate. The campaign looked at each of these and decided.

pauseReason'BUDGET_EXHAUSTED' | 'REVIEW_MODEL_UNBOUND' | 'WORKSPACE_UNAVAILABLE'

Set only while the run is PAUSED

requestedByAccountIdinteger required
startedAtstring date-time
status'AWAITING_CONFIRMATION' | 'RUNNING' | 'PAUSED' | 'COMPLETED' | 'CANCELLED' required
submittedCountinteger required

artifacts for which a review job was created

sweepScheduleIdstring uuid

The schedule that opened this run; absent for a campaign an admin scoped by hand

toAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.