GET
/
v1
/
api
/
flow-folders
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"
  }
]