Create Flow Folder
curl --request POST \
--url https://api.trillet.ai/v1/api/flow-folders \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"name": "<string>",
"color": "<string>",
"icon": "<string>",
"flowType": "<string>"
}
'import requests
url = "https://api.trillet.ai/v1/api/flow-folders"
payload = {
"name": "<string>",
"color": "<string>",
"icon": "<string>",
"flowType": "<string>"
}
headers = {
"x-workspace-id": "<x-workspace-id>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-workspace-id': '<x-workspace-id>',
'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', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'color' => '<string>',
'icon' => '<string>',
'flowType' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>",
"x-workspace-id: <x-workspace-id>"
],
]);
$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"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"color\": \"<string>\",\n \"icon\": \"<string>\",\n \"flowType\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-workspace-id", "<x-workspace-id>")
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.post("https://api.trillet.ai/v1/api/flow-folders")
.header("x-workspace-id", "<x-workspace-id>")
.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")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
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": "My Workflow Folder",
"color": "#3B82F6",
"icon": "folder",
"flowType": "call",
"pathwayModel": "Flow",
"pathways": [],
"createdAt": "2023-10-15T09:30:00Z",
"updatedAt": "2023-10-15T09:30:00Z"
}
Folder Management
Create Flow Folder
Create a new flow folder in the specified workspace.
POST
/
v1
/
api
/
flow-folders
Create Flow Folder
curl --request POST \
--url https://api.trillet.ai/v1/api/flow-folders \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"name": "<string>",
"color": "<string>",
"icon": "<string>",
"flowType": "<string>"
}
'import requests
url = "https://api.trillet.ai/v1/api/flow-folders"
payload = {
"name": "<string>",
"color": "<string>",
"icon": "<string>",
"flowType": "<string>"
}
headers = {
"x-workspace-id": "<x-workspace-id>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-workspace-id': '<x-workspace-id>',
'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', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'color' => '<string>',
'icon' => '<string>',
'flowType' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>",
"x-workspace-id: <x-workspace-id>"
],
]);
$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"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"color\": \"<string>\",\n \"icon\": \"<string>\",\n \"flowType\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-workspace-id", "<x-workspace-id>")
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.post("https://api.trillet.ai/v1/api/flow-folders")
.header("x-workspace-id", "<x-workspace-id>")
.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")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
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": "My Workflow Folder",
"color": "#3B82F6",
"icon": "folder",
"flowType": "call",
"pathwayModel": "Flow",
"pathways": [],
"createdAt": "2023-10-15T09:30:00Z",
"updatedAt": "2023-10-15T09:30:00Z"
}
Headers
string
required
The ID of the workspace to create the folder in.
Request Body
string
required
The name of the folder (e.g., “My 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
required
The type of flow. Possible values: “call” or “message”.
Response Fields
string
The unique identifier for the newly created folder.
string
The identifier of the workspace where the folder has been created.
string
The name given to the folder.
string
The color of the folder, as a hex code (e.g., “#3B82F6” for blue).
string
The icon identifier for the folder (e.g., “folder”).
string
The type of flow, either “call” or “message”.
string
The model type for flows, derived from
flowType.array
An array of flows associated with the folder (initially empty).
string
Timestamp when the folder was created (ISO 8601 format).
string
Timestamp when the folder was last updated (ISO 8601 format).
Example Request
{
"name": "My Workflow Folder",
"color": "blue",
"icon": "folder",
"flowType": "call"
}
Example Response (201 Created)
{
"_id": "folder123",
"workspaceId": "workspace456",
"name": "My Workflow Folder",
"color": "#3B82F6",
"icon": "folder",
"flowType": "call",
"pathwayModel": "Flow",
"pathways": [],
"createdAt": "2023-10-15T09:30:00Z",
"updatedAt": "2023-10-15T09:30:00Z"
}