Skip to main content
GET
List files in a data connector

Authorizations

Authorization
string
header
required

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

Path Parameters

id
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.

to
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.

bucket
string

Bucket name. Required for S3 and GCS connectors.

prefix
string

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

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

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.