> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudglue.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Metadata Imports > List a collection's metadata imports, newest first, each with its latest run inline. ## OpenAPI ````yaml GET /collections/{collection_id}/imports openapi: 3.0.0 info: title: Cloudglue API description: API for Cloudglue license: name: Apache License 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: 0.7.17 servers: - url: https://api.cloudglue.dev/v1 security: - bearerAuth: [] paths: /collections/{collection_id}/imports: get: tags: - Metadata Imports summary: List metadata imports description: >- List a collection's metadata imports, newest first, each with its latest run inline. operationId: listMetadataImports parameters: - name: collection_id in: path required: true description: The ID of the metadata collection schema: type: string format: uuid - name: limit in: query required: false description: Maximum number of imports to return (default 50) schema: type: integer maximum: 100 minimum: 1 - name: offset in: query required: false description: Number of imports to skip schema: type: integer minimum: 0 responses: '200': description: Imports for the collection content: application/json: schema: $ref: '#/components/schemas/MetadataImportList' '404': description: Collection not found content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: An unexpected error occurred on the server content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: MetadataImportList: type: object properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/MetadataImport' total: type: integer limit: type: integer offset: type: integer Error: required: - error type: object properties: error: type: string MetadataImport: type: object description: >- A saved bulk metadata import: which connector to list, how to filter it, and how runs behave. Definitions are immutable — delete and recreate to change one. properties: object: type: string enum: - metadata_import id: type: string format: uuid collection_id: type: string format: uuid connector_id: type: string format: uuid name: type: string filters: type: array items: $ref: '#/components/schemas/MetadataImportFilterSet' description: >- Listing passes; an empty array means one unfiltered pass. Overlapping passes are deduplicated on import. default_mode: type: string enum: - append - refresh description: Mode used when a run does not specify one delete_missing: type: boolean description: Default delete-missing behavior for refresh runs rate_limit: type: integer nullable: true description: >- Upstream list requests per second; null means the per-connector safe default. Clamped to a per-connector ceiling at run time. created_at: type: number description: Unix timestamp in milliseconds latest_run: allOf: - $ref: '#/components/schemas/MetadataImportRun' nullable: true description: Most recent run, or null when the import has never run max_files: type: integer nullable: true description: >- Per-run ceiling on files processed from the listing; null means unbounded include_thumbnails: type: boolean description: >- Whether runs copy connector poster images as default thumbnails for imported files (Grain and iconik today) MetadataImportFilterSet: type: object description: >- One listing pass over the connector's source — the same query params as GET /data-connectors/{id}/files. Which keys a connector honors is validated at import creation (an unsupported key is rejected with a 400, never silently dropped): google-drive supports from/to/title_search/folder_id; dropbox from/to/title_search/path; zoom and gong from/to/title_search; grain from/to/title_search/team/meeting_type; recall from/to; iconik from/to/title_search. Zoom and Gong listings default to a 6-month lookback when no `from` is given; creation pins that date into the stored filters (six months before the set's `to` when one is given, else before creation time) so every run lists the same stable window — pass an explicit `from` to control the window yourself. iconik returns at most the first 10,000 results per filter set — split larger imports into multiple date-window sets. additionalProperties: false properties: from: type: string format: date description: Only include source files from on/after this date (YYYY-MM-DD, UTC) to: type: string format: date description: Only include source files from on/before this date (YYYY-MM-DD, UTC) folder_id: type: string description: >- Restrict listing to a folder's direct children (Google Drive only). Omit to list the entire corpus. path: type: string description: >- Restrict listing to a folder path (Dropbox only). Dropbox listing is non-recursive: an import ingests only the direct children of this path (or of the root when omitted — typically all folders, i.e. nothing). Use one filter set per folder to cover a tree. title_search: type: string description: Only include files whose title matches this search team: type: string description: Restrict to a team (Grain only) meeting_type: type: string description: Restrict to a meeting type (Grain only) MetadataImportRun: type: object description: One execution of a metadata import. properties: object: type: string enum: - metadata_import_run id: type: string format: uuid import_id: type: string format: uuid mode: type: string enum: - append - refresh description: >- append imports new files and retries previously-failed ones; refresh re-imports everything the filters match delete_missing: type: boolean description: >- Whether this run sweeps files this import previously brought in that the source no longer returns (refresh runs only) status: type: string enum: - pending - processing - completed - failed - cancelled progress: $ref: '#/components/schemas/MetadataImportRunProgress' error: type: string nullable: true description: User-facing failure reason when status is failed started_at: type: number nullable: true description: Unix timestamp in milliseconds completed_at: type: number nullable: true description: Unix timestamp in milliseconds created_at: type: number description: Unix timestamp in milliseconds max_files: type: integer nullable: true description: The cap this run executed with; null means unbounded include_thumbnails: type: boolean description: Whether this run copied poster thumbnails MetadataImportRunProgress: type: object description: >- 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. properties: pages_listed: type: integer description: Connector list pages fetched files_listed: type: integer description: Source files seen across all filter sets files_created: type: integer description: New Cloudglue files created files_updated: type: integer description: Existing files re-imported (refresh mode) files_skipped: type: integer description: Already-imported files left untouched (append mode) files_failed: type: integer description: Files whose metadata indexing failed files_queued: type: integer description: >- Files handed to indexing — the denominator for progress (indexed + failed settle against it) files_indexed: type: integer description: Files whose metadata finished indexing files_removed: type: integer description: Files removed by the delete-missing sweep securitySchemes: bearerAuth: type: http scheme: bearer ````