List app folders

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the folders you can see in the workspace: its workspace folders, which every member sees, and your personal folders, which only you see.

A folder holds builder apps or agents, never both. Set app_type to user_agent to list agent folders.

Each folder names the folder it sits in through parent_folder_id, so build the tree from that. This returns folders only. To list the apps in a folder, call List apps with folder_id.

This is limited to 300 requests per minute. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this with a personal access token sent as a Bearer token, or from a signed-in session. A token works on its own workspace's folders. Workspace API keys aren't accepted, and a read-only token works.</Note>

{
  "workspace_folders": [
    {
      "app_type": "user_app",
      "color": "#3B82F6",
      "created_date": "2026-08-01T09:15:00",
      "icon": "briefcase",
      "id": "68c1f2a9b4e7d3005a2c9e11",
      "name": "Client projects",
      "position": 2,
      "scope": "workspace"
    }
  ],
  "personal_folders": [
    {
      "app_type": "user_app",
      "color": "#3B82F6",
      "created_date": "2026-08-01T09:15:00",
      "icon": "briefcase",
      "id": "68c1f27eb4e7d3005a2c9e0f",
      "name": "Drafts",
      "position": 1,
      "scope": "personal"
    }
  ],
  "favorite_folder_ids": [
    "68c1f2a9b4e7d3005a2c9e11"
  ]
}