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"
}
Folder Management
Update Folder
Update the details of a specific folder identified by its folderId.
PATCH
/
v1
/
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"
}