Skip to main content
POST
Reconcile burn-in policy progress (internal)

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

site_slug
string
required
Pattern: ^[-a-zA-Z0-9_]+$
satellite_name
string
required
resource_class
string
required
Maximum string length: 255
gate
string | null
Maximum string length: 64
Pattern: ^[a-z0-9][a-z0-9._-]*$
limit
integer
default:500
Required range: 1 <= x <= 500
cursor
string | null

Response

written
integer
required
Required range: x >= 0
unchanged
integer
required

Rows already matching the derived verdict (freshness bumped only), including rows skipped because a concurrent reconcile wrote fresher state.

Required range: x >= 0
deferred
integer
required

Targets left unwritten this page because their evaluation is not materialised yet — distinguishes 'all matched' from 'all waiting on phase-1 lag' so the agent can tune its retry cadence.

Required range: x >= 0
deleted
integer
required
Required range: x >= 0
guard_tripped
boolean
required

True when end-of-sweep cleanup refused to delete rows whose target disappeared, because their count exceeded the deletion guard thresholds; those rows remain until a later sweep or operator intervention. Rows for requirements the policy has retired are deleted regardless, so a true guard_tripped can accompany a non-zero deleted count.

next_cursor
string | null
required

Cursor for the next page; null marks the final page of the sweep.

target_count
integer
required

Total targets the policy expanded to across the whole sweep, not just this page. Zero means the policy loaded successfully but currently governs nothing (e.g. no enrolled devices carry its resource class) — the caller should surface that, since every other counter also reads zero in that state.

Required range: x >= 0