Get Bulk Import

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

GET /collections/{collection_id}/imports/{import_id}

Get a bulk import

cURL

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

200

{
  "object": "metadata_import",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "collection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "connector_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "import_type": "metadata",
  "name": "<string>",
  "filters": [
    {
      "from": "2023-12-25",
      "to": "2023-12-25",
      "folder_id": "<string>",
      "path": "<string>",
      "title_search": "<string>",
      "team": "<string>",
      "meeting_type": "<string>",
      "recursive": "true"
    }
  ],
  "default_mode": "append",
  "delete_missing": true,
  "rate_limit": 123,
  "created_at": 123,
  "runs": [
    {
      "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
    }
  ],
  "total_runs": 123,
  "limit": 123,
  "offset": 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

Query Parameters

limit · integer

Maximum number of runs to return (default 20)

Required range: 1 <= x <= 100

offset · integer

Number of runs to skip

Required range: x >= 0

Response

200

application/json

The import with paged run history

An import with one page of its run history (newest first). total_runs/limit/offset make truncation visible.

object · enum<string>

Available options: metadata_import

id · string<uuid>

collection_id · string<uuid>

connector_id · string<uuid>

import_type · enum<string>

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.

Available options: metadata, media

name · string

filters · object[]

Show child attributes

default_mode · enum<string>

Available options: append, refresh

delete_missing · boolean

rate_limit · integer | null

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

created_at · number

Unix timestamp in milliseconds

runs · object[]

One page of run history, newest first

Show child attributes

total_runs · integer

limit · integer

offset · integer

max_files · integer | null

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

include_thumbnails · boolean

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

enrich_metadata · boolean

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.