Run Metadata Import
Trigger a new run of a saved import. mode and delete_missing default to the definition’s saved values. Only one run may be active per collection at a time — concurrent runs would corrupt each other’s delete-missing bookkeeping — so triggering while any run in the collection is active returns a 409.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the metadata collection
The ID of the metadata import
Body
All fields default to the values saved on the import definition.
Response
The created run
One execution of a metadata import.
metadata_import_run append imports new files and retries previously-failed ones; refresh re-imports everything the filters match
append, refresh Whether this run sweeps files this import previously brought in that the source no longer returns (refresh runs only)
pending, processing, completed, failed, cancelled Best-effort progress counters for display. Run completion is decided from the actual per-file indexing state, never from these counters, so they can drift slightly under retries without affecting correctness.
User-facing failure reason when status is failed
Unix timestamp in milliseconds
Unix timestamp in milliseconds
Unix timestamp in milliseconds
The cap this run executed with; null means unbounded
Whether this run copied poster thumbnails