Skip to content

Get one backfill run by id (progress poll)

GET
/admin/metadata-extraction/backfills/{id}

Returns the current row state — processed / succeeded / failed counters move with each coordinator-job batch boundary. Gated on system.admin.

id
required
string format: uuid

Current run state.

One backfill-coordinator run row. Counters move as the coordinator job walks the population.

object
id
required
string format: uuid
asset_type_ref
integer format: int64
nullable
total
required

Unknown at start (0). Reserved for a future “count first” pre-walk pass; current implementation leaves at 0 and the UI shows ”—” when zero + not-yet-completed.

integer format: int64
processed
required
integer format: int64
succeeded
required
integer format: int64
failed
required
integer format: int64
started_at
required
string format: date-time
completed_at
string format: date-time
nullable
cancelled_at
string format: date-time
nullable
started_by_user_ref
integer format: int64
nullable

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed