Trillet AI logo

Create Flow Folder

Create a folder for call flows or message flows in a workspace.

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

Headers

x-workspace-idstringrequired

The workspace the folder belongs to. Folders and flows in other workspaces are treated as not found.

Request Body

namestringrequired

The folder name (for example "Inbound Flows").

flowTypestringrequired

What the folder holds: call (call flows) or message (message flows). Can't be changed later.

colorstring

Any string. It is stored and returned exactly as sent, with no validation or conversion, so send a hex color such as #3B82F6. Defaults to #3498db.

iconstring

Any string, stored as sent. The portal uses folder, file, phone, headphone, voice and message. Defaults to folder.

Response (201 Created)

_idstring

The folder's unique identifier.

workspaceIdstring

The workspace the folder belongs to.

namestring

The folder name.

colorstring

The folder color, stored exactly as sent (default #3498db).

iconstring

The folder icon, stored exactly as sent (default folder).

flowTypestring

call or message.

pathwayModelstring

Pathway for call folders, MessagePathway for message folders. Set by the server from flowType.

pathwaysarray

An empty array for a new folder.

createdAtstring

When the folder was created (ISO 8601). Folders have no updatedAt.

Errors

All folder errors use a message field, not error.

StatusBodyWhen
400{"message": "x-workspace-id header is required"}x-workspace-id missing or not a valid ID
500{"message": "..."}Unexpected server error
{
  "name": "Inbound Flows",
  "flowType": "call",
  "color": "#3B82F6",
  "icon": "folder"
}
201
{
  "_id": "b2b2b2b2b2b2b2b2b2b2b2b2",
  "workspaceId": "b4b4b4b4b4b4b4b4b4b4b4b4",
  "name": "Inbound Flows",
  "color": "#3B82F6",
  "icon": "folder",
  "flowType": "call",
  "pathways": [],
  "pathwayModel": "Pathway",
  "createdAt": "2026-10-15T09:30:00.000Z",
  "__v": 0
}

Last updated on