Skip to main content
GET
List folders

Authorizations

Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Query Parameters

limit
integer
default:100

Max items to return (default 100, max 500)

Required range: 1 <= x <= 500
offset
integer | null
default:0

Number of items to skip (default 0)

Required range: x >= 0
q
string

Case-insensitive substring search on folder name or description. System-owned collection types (my-files, org-files, etc.) are excluded from results. Composes with scope.

Example:

"contracts"

scope
enum<string>

Filter folders to a single meta-collection. Requires a user-scoped API key.

Available options:
my-files,
shared-with-me,
organization
Example:

"my-files"

Response

List of folders

folders
object[]
required
pagination
object
required