Get campaign folder
curl --request GET \
--url https://openapi.enginy.ai/v1/campaigns/folders/{folderId} \
--header 'x-api-key: <api-key>'import requests
url = "https://openapi.enginy.ai/v1/campaigns/folders/{folderId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://openapi.enginy.ai/v1/campaigns/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://openapi.enginy.ai/v1/campaigns/folders/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://openapi.enginy.ai/v1/campaigns/folders/{folderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://openapi.enginy.ai/v1/campaigns/folders/{folderId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://openapi.enginy.ai/v1/campaigns/folders/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"parentId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"campaignsCount": 123,
"subfoldersCount": 123,
"children": [
{
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"_count": {
"campaign": 123,
"children": 123
}
}
],
"parent": {
"id": 123,
"appUrl": "<string>",
"name": "<string>"
},
"campaign": [
{
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"description": "<string>",
"folderId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": {
"id": 123,
"name": "<string>"
},
"_count": {
"conversation": 123
}
}
],
"ancestors": [
{
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"parentId": 123
}
],
"totalSubfoldersCount": 123,
"totalCampaignsCount": 123
}
}Campaigns
Get campaign folder
Get a campaign folder with its child folders, campaigns, and breadcrumb ancestors.
Responses include direct Enginy app URLs when available. Responses include appUrl values for the folder and nested campaigns or related folders when available. MCP agents should return those URLs to users whenever they are present in the response.
Required scope:
CAMPAIGNS_READRate limit: 100 requests per minute
GET
/
v1
/
campaigns
/
folders
/
{folderId}
Get campaign folder
curl --request GET \
--url https://openapi.enginy.ai/v1/campaigns/folders/{folderId} \
--header 'x-api-key: <api-key>'import requests
url = "https://openapi.enginy.ai/v1/campaigns/folders/{folderId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://openapi.enginy.ai/v1/campaigns/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://openapi.enginy.ai/v1/campaigns/folders/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://openapi.enginy.ai/v1/campaigns/folders/{folderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://openapi.enginy.ai/v1/campaigns/folders/{folderId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://openapi.enginy.ai/v1/campaigns/folders/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"parentId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"campaignsCount": 123,
"subfoldersCount": 123,
"children": [
{
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"_count": {
"campaign": 123,
"children": 123
}
}
],
"parent": {
"id": 123,
"appUrl": "<string>",
"name": "<string>"
},
"campaign": [
{
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"description": "<string>",
"folderId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": {
"id": 123,
"name": "<string>"
},
"_count": {
"conversation": 123
}
}
],
"ancestors": [
{
"id": 123,
"appUrl": "<string>",
"name": "<string>",
"parentId": 123
}
],
"totalSubfoldersCount": 123,
"totalCampaignsCount": 123
}
}⌘I