Skip to main content
GET
/
folders
List folders
curl --request GET \
  --url https://app.generalcounsel.ai/api/external/v1/folders \
  --header 'Authorization: <api-key>'
{
  "folders": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "path": "/My Files/Contracts",
      "parent_folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "folder_type": "<string>",
      "created_at": "<string>"
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "has_more": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gc.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

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

Query Parameters

​
limit
integer

Max folders to return (default 100, max 500)

Required range: 0 < x <= 500
​
offset
integer

Number of folders to skip (default 0)

Required range: x >= 0
​
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