Delete Folder

Delete a specific folder identified by its folderId and remove its reference from associated flows.

DELETE /v1/api/flow-folders/{folderId}

Delete Folder

cURL

curl --request DELETE \
  --url https://api.trillet.ai/v1/api/flow-folders/{folderId} \
  --header 'x-api-key: <api-key>'

{
  "_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"
}

Path Parameters

folderId · string · required

The unique identifier of the folder to delete.

Response Fields

_id · string

The unique identifier of the deleted folder.

workspaceId · string

The identifier of the workspace where the folder belonged.

name · string

The name of the deleted folder.

color · string

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

icon · string

The icon identifier for the deleted 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 that were associated with the deleted 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"
}