Cancel Bulk Import Run

Cancel an in-flight run. Files already imported by the run are kept. Cancelling an already-finished run is a no-op that returns the current state.

POST /collections/{collection_id}/imports/{import_id}/runs/{run_id}/cancel

Cancel a bulk import run

cURL

curl --request POST \
  --url https://api.cloudglue.dev/v1/collections/{collection_id}/imports/{import_id}/runs/{run_id}/cancel \
  --header 'Authorization: Bearer <token>'

200

{
  "object": "metadata_import_run",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "import_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "import_type": "metadata",
  "mode": "append",
  "delete_missing": true,
  "status": "pending",
  "progress": {
    "pages_listed": 123,
    "files_listed": 123,
    "files_created": 123,
    "files_updated": 123,
    "files_skipped": 123,
    "files_failed": 123,
    "files_queued": 123,
    "files_indexed": 123,
    "files_imported": 123,
    "files_removed": 123,
    "files_enriched": 123
  },
  "error": "<string>",
  "started_at": 123,
  "completed_at": 123,
  "created_at": 123,
  "max_files": 123,
  "include_thumbnails": true,
  "enrich_metadata": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

collection_id · string<uuid> · required

The ID of the metadata collection

import_id · string<uuid> · required

The ID of the metadata import

run_id · string<uuid> · required

The ID of the import run

Response

200

application/json

The run in its post-cancel state

One execution of a metadata import.

object · enum<string>

Available options: metadata_import_run

id · string<uuid>

import_id · string<uuid>

import_type · enum<string>

What this run ingests, inherited from the import definition: metadata indexes source metadata only (free); media ingests and processes the actual files (billed per file).

Available options: metadata, media

mode · enum<string>

append imports new files and retries previously-failed ones; refresh re-imports everything the filters match. For media imports, refresh re-syncs the source metadata of files it already imported — media bytes are never re-downloaded.

Available options: append, refresh

delete_missing · boolean

Whether this run sweeps files this import previously brought in that the source no longer returns (refresh runs only)

status · enum<string>

Available options: pending, processing, completed, failed, cancelled

progress · object

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.

Show child attributes

error · string | null

User-facing failure reason when status is failed

started_at · number | null

Unix timestamp in milliseconds

completed_at · number | null

Unix timestamp in milliseconds

created_at · number

Unix timestamp in milliseconds

max_files · integer | null

The cap this run executed with; null means unbounded

include_thumbnails · boolean

Whether this run copied poster thumbnails

enrich_metadata · boolean

Whether this run backfills omitted source-metadata fields (see the import-level property).