Update Folder

curl --request PATCH \
  --url https://api.trillet.ai/v1/api/flow-folders/{folderId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "color": "<string>",
  "icon": "<string>",
  "flowType": "<string>"
}
'

import requests

url = "https://api.trillet.ai/v1/api/flow-folders/{folderId}"

payload = {
    "name": "<string>",
    "color": "<string>",
    "icon": "<string>",
    "flowType": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', color: '<string>', icon: '<string>', flowType: '<string>'})
};

fetch('https://api.trillet.ai/v1/api/flow-folders/{folderId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trillet.ai/v1/api/flow-folders/{folderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'color' => '<string>',
    'icon' => '<string>',
    'flowType' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trillet.ai/v1/api/flow-folders/{folderId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"color\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"flowType\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.trillet.ai/v1/api/flow-folders/{folderId}")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"color\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"flowType\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trillet.ai/v1/api/flow-folders/{folderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"color\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"flowType\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

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

PATCH

api

flow-folders

{folderId}

Update Folder

curl --request PATCH \
  --url https://api.trillet.ai/v1/api/flow-folders/{folderId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "color": "<string>",
  "icon": "<string>",
  "flowType": "<string>"
}
'

import requests

url = "https://api.trillet.ai/v1/api/flow-folders/{folderId}"

payload = {
    "name": "<string>",
    "color": "<string>",
    "icon": "<string>",
    "flowType": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', color: '<string>', icon: '<string>', flowType: '<string>'})
};

fetch('https://api.trillet.ai/v1/api/flow-folders/{folderId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trillet.ai/v1/api/flow-folders/{folderId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'color' => '<string>',
    'icon' => '<string>',
    'flowType' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trillet.ai/v1/api/flow-folders/{folderId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"color\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"flowType\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.trillet.ai/v1/api/flow-folders/{folderId}")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"color\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"flowType\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trillet.ai/v1/api/flow-folders/{folderId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"color\": \"<string>\",\n  \"icon\": \"<string>\",\n  \"flowType\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

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

Path Parameters

string

required

The unique identifier of the folder to update.

Request Body

string

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

string

required

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

string

required

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

string

The updated type of flow, either “call” or “message”.

Response Fields

string

The unique identifier of the folder.

string

The identifier of the workspace where the folder belongs.

string

The updated name of the folder.

string

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

string

The updated icon identifier for the folder.

string

The updated type of flow, either “call” or “message”.

string

The model type for flows, derived from flowType.

array

An array of flow IDs associated with the folder.

string

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

string

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

API Reference V1

Workspaces

Calls

Batch Calls

Telephony

Conversations

Folder Management

Call Flows

Message Flows

Call Agents

Omni Flow Agents (Message)

Knowledge Base

Active Calls

Recordings

Update Folder

Path Parameters

Request Body

Response Fields

Example Request

​Path Parameters

​Request Body

​Response Fields

​Example Request

Path Parameters

Request Body

Response Fields

Example Request