> ## 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 Data Connector Files

> Browse files available in a connected data source. Returns URIs compatible with Cloudglue's file import system, and per-file provider metadata (see the `metadata` field) so you can inspect participants, hosts, durations, and AI summaries before importing. Supports pagination and filtering: `from`/`to` and `title_search` are shared filters honored by every connector that can (see each parameter's support matrix); parameters a connector can't honor are silently ignored. When filters are applied, a page may contain fewer than `limit` items — even zero — while `has_more` is still true: continue paginating until `next_page_token` is null rather than stopping at the first short or empty page.



## OpenAPI

````yaml GET /data-connectors/{id}/files
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.13
servers:
  - url: https://api.cloudglue.dev/v1
security:
  - bearerAuth: []
paths:
  /data-connectors/{id}/files:
    get:
      tags:
        - Data Connectors
      summary: List files in a data connector
      description: >-
        Browse files available in a connected data source. Returns URIs
        compatible with Cloudglue's file import system, and per-file provider
        metadata (see the `metadata` field) so you can inspect participants,
        hosts, durations, and AI summaries before importing. Supports pagination
        and filtering: `from`/`to` and `title_search` are shared filters honored
        by every connector that can (see each parameter's support matrix);
        parameters a connector can't honor are silently ignored. When filters
        are applied, a page may contain fewer than `limit` items — even zero —
        while `has_more` is still true: continue paginating until
        `next_page_token` is null rather than stopping at the first short or
        empty page.
      operationId: listDataConnectorFiles
      parameters:
        - name: id
          in: path
          description: The ID of the data connector
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          description: Maximum number of files to return (1-100)
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: page_token
          in: query
          description: >-
            Opaque cursor for pagination. Use the `next_page_token` from a
            previous response. Tokens are only valid with the same filter
            parameters they were issued under.
          required: false
          schema:
            type: string
        - name: from
          in: query
          description: >-
            Start date for filtering (YYYY-MM-DD, inclusive UTC day bound).
            Native for Zoom and Gong (call start; both default to a 6-month
            lookback when omitted), Grain and Recall (recording start/created
            time), iconik (asset date_created), and Google Drive (createdTime);
            matched while listing for Dropbox (client_modified). Ignored for
            S3/GCS.
          required: false
          schema:
            type: string
            format: date
        - name: to
          in: query
          description: >-
            End date for filtering (YYYY-MM-DD, inclusive UTC day bound). Same
            per-connector support as `from`. Ignored for S3/GCS.
          required: false
          schema:
            type: string
            format: date
        - name: folder_id
          in: query
          description: >-
            Google Drive folder ID to list contents of. Applies to Google Drive
            connectors only.
          required: false
          schema:
            type: string
        - name: path
          in: query
          description: >-
            Dropbox folder path to list contents of (default: root). Applies to
            Dropbox connectors only.
          required: false
          schema:
            type: string
        - name: bucket
          in: query
          description: Bucket name. Required for S3 and GCS connectors.
          required: false
          schema:
            type: string
        - name: prefix
          in: query
          description: Key prefix filter. Applies to S3 and GCS connectors only.
          required: false
          schema:
            type: string
        - name: title_search
          in: query
          description: >-
            Case-insensitive title filter. Native for Grain (title_search),
            Google Drive (name contains), and iconik (full-text title search);
            matched while listing for Zoom (topic), Gong (call title), and
            Dropbox (filename). Ignored for Recall (no title is available when
            listing) and S3/GCS.
          required: false
          schema:
            type: string
        - name: team
          in: query
          description: >-
            Team filter. Applies to Grain connectors only. See the [Grain
            documentation](https://developers.grain.com/#recording-filter) for
            more details.
          required: false
          schema:
            type: string
        - name: meeting_type
          in: query
          description: >-
            Meeting type filter. Applies to Grain connectors only. See the
            [Grain
            documentation](https://developers.grain.com/#recording-filter) for
            more details.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: A list of files and folders
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataConnectorFileList'
        '400':
          description: >-
            Bad request (e.g. missing required bucket parameter, unsupported
            connector type)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Data connector 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'
        '502':
          description: Error communicating with the external service
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    DataConnectorFileList:
      type: object
      properties:
        object:
          type: string
          enum:
            - list
          description: Object type, always 'list'
        data:
          type: array
          items:
            $ref: '#/components/schemas/DataConnectorFile'
          description: Array of file and folder objects
        has_more:
          type: boolean
          description: Whether more results are available
        next_page_token:
          type: string
          nullable: true
          description: >-
            Opaque cursor to pass as page_token for the next page. Null when
            there are no more results.
      required:
        - object
        - data
        - has_more
        - next_page_token
    Error:
      required:
        - error
      type: object
      properties:
        error:
          type: string
    DataConnectorFile:
      type: object
      properties:
        object:
          type: string
          enum:
            - data_connector_file
          description: Object type, always 'data_connector_file'
        type:
          type: string
          enum:
            - file
            - folder
          description: Whether this entry is a file or a folder
        uri:
          type: string
          nullable: true
          description: URI for importing the file into Cloudglue. Null for folders.
        name:
          type: string
          description: Display name of the file or folder
        mime_type:
          type: string
          nullable: true
          description: MIME type of the file, if available
        size_bytes:
          type: integer
          nullable: true
          description: File size in bytes, if available
        created_at:
          type: integer
          nullable: true
          description: Creation timestamp in milliseconds since epoch, if available
        thumbnail_url:
          type: string
          nullable: true
          description: >-
            Ephemeral preview image for the file — a signed provider URL that
            expires within hours. Display-only: never store it. Currently
            populated for iconik (the asset's poster keyframe, honoring a custom
            keyframe when one is set); null or absent for other connectors.
        metadata:
          type: object
          properties:
            folder_id:
              type: string
              description: >-
                Google Drive folder ID. Pass back as the `folder_id` query
                parameter to drill into this folder.
            path:
              type: string
              description: >-
                Dropbox folder path. Pass back as the `path` query parameter to
                drill into this folder.
            prefix:
              type: string
              description: >-
                S3/GCS key prefix. Pass back as the `prefix` query parameter to
                drill into this virtual folder.
          additionalProperties: true
          description: >-
            Provider-specific metadata. Folder entries expose the navigation key
            to pass back on the next request. File entries from Grain, Zoom,
            Recall, Google Drive, Dropbox, and Gong carry the provider's
            SourceMetadata shape (see the SourceMetadata schema) — the same
            provenance that lands on the file's `source_metadata` after syncing,
            so you can inspect participants, hosts, durations, AI summaries,
            etc. while browsing. S3/GCS file entries carry an empty object. Some
            fields are only captured at sync time (Dropbox media_info, Gong AI
            content).
      required:
        - object
        - type
        - uri
        - name
        - mime_type
        - size_bytes
        - created_at
        - metadata
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````