Bulk Imports

Get a bulk import

Changed on

Get a metadata import definition with one page of its run history (newest first).

get/collections/{collection_id}/imports/{import_id}

Request

  • Base URL
    https://api.cloudglue.dev/v1
  • Auth
    HTTP bearer

Path parameters

collection_idstring uuid required

The ID of the metadata collection

import_idstring uuid required

The ID of the metadata import

Query parameters

limitinteger

Maximum number of runs to return (default 20)

offsetinteger

Number of runs to skip

Response

The import with paged run history

object'metadata_import'
idstring uuid
collection_idstring uuid
connector_idstring uuid
import_type'metadata' | 'media'

Inferred from the collection's type at creation and fixed for the import's lifetime. metadata (metadata collections): source metadata is indexed, no media is downloaded, runs are free. media (every other collection type): each matching file is ingested and processed exactly like a manual add, billed per file.

namestring
default_mode'append' | 'refresh'
delete_missingboolean
rate_limitinteger nullable

Upstream list requests per second; null means the per-connector safe default. Clamped to a per-connector ceiling at run time.

created_atnumber

Unix timestamp in milliseconds

total_runsinteger
limitinteger
offsetinteger
max_filesinteger nullable

Per-run ceiling on files processed from the listing; null means unbounded

include_thumbnailsboolean

Whether runs copy connector poster images as default thumbnails for imported files (Grain and iconik today)

enrich_metadataboolean

Backfill source-metadata fields the connector's list endpoint omits, after each index batch settles: Gong parties + Call Spotlight content (batched - enriched docs are re-embedded so the content is searchable) and Dropbox media_info duration/dimensions (per-file). No-op for other connectors. Off by default: it spends upstream API budget and, for Gong, embedding work. Metadata imports only — setting it on a media import is a 400, since a media run ingests each file in full and has no metadata-only record to enrich.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      api tag Bulk Imports added

    • info

      api tag Metadata Imports removed

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status