List files in a data connector

curl --request GET \
  --url https://api.cloudglue.dev/v1/data-connectors/{id}/files \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cloudglue.dev/v1/data-connectors/{id}/files', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cloudglue.dev/v1/data-connectors/{id}/files",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cloudglue.dev/v1/data-connectors/{id}/files"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cloudglue.dev/v1/data-connectors/{id}/files")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "data_connector_file",
      "type": "file",
      "uri": "<string>",
      "name": "<string>",
      "mime_type": "<string>",
      "size_bytes": 123,
      "created_at": 123,
      "metadata": {
        "folder_id": "<string>",
        "path": "<string>",
        "prefix": "<string>"
      },
      "thumbnail_url": "<string>"
    }
  ],
  "has_more": true,
  "next_page_token": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Data Connectors

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.

GET

data-connectors

{id}

files

List files in a data connector

curl --request GET \
  --url https://api.cloudglue.dev/v1/data-connectors/{id}/files \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cloudglue.dev/v1/data-connectors/{id}/files', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cloudglue.dev/v1/data-connectors/{id}/files",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cloudglue.dev/v1/data-connectors/{id}/files"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cloudglue.dev/v1/data-connectors/{id}/files")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "data_connector_file",
      "type": "file",
      "uri": "<string>",
      "name": "<string>",
      "mime_type": "<string>",
      "size_bytes": 123,
      "created_at": 123,
      "metadata": {
        "folder_id": "<string>",
        "path": "<string>",
        "prefix": "<string>"
      },
      "thumbnail_url": "<string>"
    }
  ],
  "has_more": true,
  "next_page_token": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string<uuid>

required

The ID of the data connector

Query Parameters

limit

integer

default:20

Maximum number of files to return (1-100)

Required range: 1 <= x <= 100

page_token

string

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.

from

string<date>

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.

string<date>

End date for filtering (YYYY-MM-DD, inclusive UTC day bound). Same per-connector support as from. Ignored for S3/GCS.

folder_id

string

Google Drive folder ID to list contents of. Applies to Google Drive connectors only.

path

string

Dropbox folder path to list contents of (default: root). Applies to Dropbox connectors only.

recursive

enum<string>

Dropbox only: 'true' lists the whole subtree under path (or the whole account when no path is given) instead of its direct children. Ignored by every other connector. Built for bulk metadata imports; interactive browsing should stay non-recursive.

Available options:

true,

false

bucket

string

Bucket name. Required for S3 and GCS connectors.

prefix

string

Key prefix filter. Applies to S3 and GCS connectors only.

title_search

string

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.

team

string

Team filter. Applies to Grain connectors only. See the Grain documentation for more details.

meeting_type

string

Meeting type filter. Applies to Grain connectors only. See the Grain documentation for more details.

Response

A list of files and folders

object

enum<string>

required

Object type, always 'list'

Available options:

list

data

object[]

required

Array of file and folder objects

Show child attributes

has_more

boolean

required

Whether more results are available

next_page_token

string | null

required

Opaque cursor to pass as page_token for the next page. Null when there are no more results.

Using the API

Files

Extract

Describe

Segments

Find Moments

Common Collection Operations

Response

Deep Search

Query

Search

Chat

Media Description Collection

Entity Collection

Face Analysis Collection

Moments Collection

Thumbnails

Segmentation

File Segments

Frames

Face Match

Face Detection

Share

Sites

Tags

Data Connectors

Bulk Imports

Webhooks

Transcribe (Legacy)

Rich Transcripts Collection (Legacy)

List Data Connector Files

Authorizations

Path Parameters

Query Parameters

Response