Trillet AI logo

Update Folder

Update the details of a specific folder identified by its folderId.

PATCHhttps://api.trillet.ai/v1/api/flow-folders/{folderId}

Path Parameters

folderIdstringrequired

The unique identifier of the folder to update.

Request Body

namestring

The updated name of the folder (e.g., "Updated Workflow Folder").

colorstringrequired

The color of the folder, specified as one of the following color names with their corresponding hex codes: blue (#3B82F6), green (#10B981), teal (#14B8A6), purple (#8B5CF6), orange (#F97316), red (#EF4444).

iconstringrequired

The icon identifier for the folder, specified as one of the following: folder, file, phone, headphone, voice, message.

flowTypestring

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

Response Fields

_idstring

The unique identifier of the folder.

workspaceIdstring

The identifier of the workspace where the folder belongs.

namestring

The updated name of the folder.

colorstring

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

iconstring

The updated icon identifier for the folder.

flowTypestring

The updated 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).

Example Request

{
  "name": "Updated Workflow Folder",
  "color": "#00FF00",
  "icon": "new-folder-icon"
}
{
  "_id": "folder123",
  "workspaceId": "workspace456",
  "name": "Updated Workflow Folder",
  "color": "#00FF00",
  "icon": "new-folder-icon",
  "flowType": "call",
  "pathwayModel": "Flow",
  "pathways": ["flow123"],
  "createdAt": "2023-10-15T09:30:00Z",
  "updatedAt": "2023-10-16T12:00:00Z"
}