Skip to main content
GET
/
v1
/
api
/
flow-folders
Get All Folders for Workspace
curl --request GET \
  --url https://api.trillet.ai/v1/api/flow-folders \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
[
  {
    "_id": "folder123",
    "workspaceId": "workspace456",
    "name": "My Workflow Folder",
    "color": "#FF0000",
    "icon": "folder-icon",
    "flowType": "call",
    "pathwayModel": "Flow",
    "pathways": ["flow123"],
    "createdAt": "2023-10-15T09:30:00Z",
    "updatedAt": "2023-10-15T10:00:00Z"
  },
  {
    "_id": "folder124",
    "workspaceId": "workspace456",
    "name": "Message Folder",
    "color": "#00FF00",
    "icon": "message-icon",
    "flowType": "message",
    "pathwayModel": "MessageFlow",
    "pathways": [],
    "createdAt": "2023-10-14T08:00:00Z",
    "updatedAt": "2023-10-14T08:00:00Z"
  }
]

​
Headers

​
x-workspace-id
string
required
The ID of the workspace whose folders are being requested.

​
Response Fields

An array of folder objects, each containing the following fields:
​
_id
string
The unique identifier of the folder.
​
workspaceId
string
The identifier of the workspace where the folder belongs.
​
name
string
The name of the folder.
​
color
string
The color of the folder, represented as a hex code.
​
icon
string
The icon identifier for the folder.
​
flowType
string
The type of flow, either “call” or “message”.
​
pathwayModel
string
The model type for flows, derived from flowType.
​
pathways
array
An array of flow IDs associated with the folder.
​
createdAt
string
Timestamp when the folder was created (ISO 8601 format).
​
updatedAt
string
Timestamp when the folder was last updated (ISO 8601 format).
[
  {
    "_id": "folder123",
    "workspaceId": "workspace456",
    "name": "My Workflow Folder",
    "color": "#FF0000",
    "icon": "folder-icon",
    "flowType": "call",
    "pathwayModel": "Flow",
    "pathways": ["flow123"],
    "createdAt": "2023-10-15T09:30:00Z",
    "updatedAt": "2023-10-15T10:00:00Z"
  },
  {
    "_id": "folder124",
    "workspaceId": "workspace456",
    "name": "Message Folder",
    "color": "#00FF00",
    "icon": "message-icon",
    "flowType": "message",
    "pathwayModel": "MessageFlow",
    "pathways": [],
    "createdAt": "2023-10-14T08:00:00Z",
    "updatedAt": "2023-10-14T08:00:00Z"
  }
]