Skip to content
Artist Alley

List recent metadata-extraction backfill runs

GET
/admin/metadata-extraction/backfills

Returns up to limit most-recently-started backfill runs (default 20, cap 50). Gated on system.admin. Powers the operator-history table on the backfill admin page.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit
integer
default: 20 >= 1 <= 50

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Backfill runs newest-first.

object
items
required
Array<object>

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

401

Section titled “401 ”

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"
}

403

Section titled “403 ”

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed