Get All Folders
List every flow folder in the workspace.
Returns call and message folders together, newest first. Each folder lists only the IDs of its flows. Use Get Folder Details for the flows themselves.
Headers
x-workspace-idstringrequiredThe workspace the folder belongs to. Folders and flows in other workspaces are treated as not found.
Response
An array of folders. Each folder has these fields:
_idstringThe folder's unique identifier.
workspaceIdstringThe workspace the folder belongs to.
namestringThe folder name.
colorstringThe folder color, stored exactly as sent (default #3498db).
iconstringThe folder icon, stored exactly as sent (default folder).
flowTypestringcall or message.
pathwayModelstringPathway for call folders, MessagePathway for message folders. Set by the server from flowType.
pathwaysarrayThe _ids of the flows in the folder.
createdAtstringWhen the folder was created (ISO 8601). Folders have no updatedAt.
Errors
All folder errors use a message field, not error.
| Status | Body | When |
|---|---|---|
400 | {"message": "x-workspace-id header is required"} | x-workspace-id missing or not a valid ID |
500 | {"message": "..."} | Unexpected server error |
[
{
"_id": "b2b2b2b2b2b2b2b2b2b2b2b2",
"workspaceId": "b4b4b4b4b4b4b4b4b4b4b4b4",
"name": "Inbound Flows",
"color": "#3B82F6",
"icon": "folder",
"flowType": "call",
"pathways": [
"b7b7b7b7b7b7b7b7b7b7b7b7"
],
"pathwayModel": "Pathway",
"createdAt": "2026-10-15T09:30:00.000Z",
"__v": 0
}
]Last updated on