Trillet AI logo

Get All Folders for Workspace

Retrieve all folders associated with a specific workspace, identified by the workspace ID in the request header.

GEThttps://api.trillet.ai/v1/api/flow-folders

Headers

x-workspace-idstringrequired

The ID of the workspace whose folders are being requested.

Response Fields

An array of folder objects, each containing the following fields:

_idstring

The unique identifier of the folder.

workspaceIdstring

The identifier of the workspace where the folder belongs.

namestring

The name of the folder.

colorstring

The color of the folder, represented as a hex code.

iconstring

The icon identifier for the folder.

flowTypestring

The type of flow, either "call" or "message".

pathwayModelstring

The model type for flows, derived from flowType.

pathwaysarray

An array of flow IDs associated with the folder.

createdAtstring

Timestamp when the folder was created (ISO 8601 format).

updatedAtstring

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"
  }
]