List pending metadata-extraction failures

GET

/admin/metadata-extraction/failures

• Local development behind nginx (port 8088 by default)

Returns paginated pending (not-yet-dismissed) rows from extraction_failure. Filterable by error_kind + format. Gated on system.admin.

Pending count for the admin nav badge is returned alongside the page so the UI can render the badge from one round-trip.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Query Parameters

error_kind

string

Filter by failure kind (unsupported_format / malformed_file / library_panic / validation). Omit for all kinds.

format

string

Filter by source MIME type (e.g. image/jpeg).

limit

integer

default: 50 >= 1 <= 200

offset

integer

0

Responses

200

Pending failure rows + the total pending count.

object

items

required

Array<object>

One row in the metadata extraction_failure queue (Phase 1.18.A-2). Represents a single per-asset failure the operator should review — unsupported MIME, malformed file, validator-rejected field value, or a recovered library panic. Dismissal is soft so the row stays for audit.

object

id

required

string format: uuid

asset_id

required

string format: uuid

format

required

Source MIME type at the time the failure occurred.

string

error_kind

required

One of: unsupported_format, malformed_file, library_panic, validation.

string

message

required

string

field_key

CanonicalField for validation failures (empty for whole-file errors). Example: camera_model.

string

raw_value

Operator-displayable raw value the extractor produced, JSONB. Empty / null for whole-file failures.

occurred_at

required

string format: date-time

dismissed_at

NULL while pending; set by the dismiss endpoint.

string format: date-time

nullable

total

required

Total pending (not-yet-dismissed) failure rows ignoring limit/offset but obeying the error_kind + format filters. Powers the admin nav badge.

integer format: int64

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

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed