Brand personas
List brand personas
Returns a list of brand personas with optional filtering, pagination, and sorting.
GET
/
agentpersonas
List brand personas
curl --request GET \
--url https://api-trial.cognigy.ai/v1/agentpersonas \
--header 'X-API-Key: <api-key>'import requests
url = "https://api-trial.cognigy.ai/v1/agentpersonas"
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://api-trial.cognigy.ai/v1/agentpersonas', 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-trial.cognigy.ai/v1/agentpersonas",
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://api-trial.cognigy.ai/v1/agentpersonas"
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://api-trial.cognigy.ai/v1/agentpersonas")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-trial.cognigy.ai/v1/agentpersonas")
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{
"items": [
{
"createdAt": 123,
"createdBy": "507f1f77bcf86cd799439011",
"description": "<string>",
"id": "507f1f77bcf86cd799439011",
"image": "<string>",
"imageOptimizedFormat": true,
"lastChangedAt": 123,
"lastChangedBy": "507f1f77bcf86cd799439011",
"name": "<string>",
"organisationId": "507f1f77bcf86cd799439011",
"projectId": "507f1f77bcf86cd799439011",
"referenceId": "<string>",
"speakingStyle": {
"completeness": "<string>",
"customInstructions": "<string>",
"formality": "<string>",
"useCustomInstructions": true
},
"voiceConfig": {
"ttsLabel": "<string>",
"ttsModel": "<string>",
"ttsVendor": "<string>",
"ttsVoice": "<string>",
"ttsDisableCache": true,
"ttsLanguage": "<string>"
}
}
],
"nextCursor": "507f1f77bcf86cd799439011",
"previousCursor": "507f1f77bcf86cd799439011",
"total": 1
}{
"detail": "request body validation failed",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"instance": "/v1/{resource}",
"status": 400,
"title": "Bad Request",
"traceId": "api--a4d2f126-bec4-4544-a049-7c0cf08524ed",
"type": "about:blank"
}{
"detail": "access denied: insufficient permissions",
"instance": "/v1/{resource}/{id}",
"status": 403,
"title": "Forbidden",
"traceId": "api--a4d2f126-bec4-4544-a049-7c0cf08524ed",
"type": "about:blank"
}{
"detail": "internal server error",
"instance": "/v1/{resource}",
"status": 500,
"title": "Internal Server Error",
"traceId": "api--a4d2f126-bec4-4544-a049-7c0cf08524ed",
"type": "about:blank"
}Authorizations
[Production] API key for production authentication
Query Parameters
The unique identifier for the project to filter by.
The string to filter by name. The filter is case-insensitive.
The maximum number of items to return, from 1 to 100. The default is 100.
The number of items to skip before starting to return results. The default is 0.
The sort order, either asc or desc. The default is asc.
The cursor for the next page of results.
The cursor for the previous page of results.
⌘I
List brand personas
curl --request GET \
--url https://api-trial.cognigy.ai/v1/agentpersonas \
--header 'X-API-Key: <api-key>'import requests
url = "https://api-trial.cognigy.ai/v1/agentpersonas"
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://api-trial.cognigy.ai/v1/agentpersonas', 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-trial.cognigy.ai/v1/agentpersonas",
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://api-trial.cognigy.ai/v1/agentpersonas"
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://api-trial.cognigy.ai/v1/agentpersonas")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-trial.cognigy.ai/v1/agentpersonas")
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{
"items": [
{
"createdAt": 123,
"createdBy": "507f1f77bcf86cd799439011",
"description": "<string>",
"id": "507f1f77bcf86cd799439011",
"image": "<string>",
"imageOptimizedFormat": true,
"lastChangedAt": 123,
"lastChangedBy": "507f1f77bcf86cd799439011",
"name": "<string>",
"organisationId": "507f1f77bcf86cd799439011",
"projectId": "507f1f77bcf86cd799439011",
"referenceId": "<string>",
"speakingStyle": {
"completeness": "<string>",
"customInstructions": "<string>",
"formality": "<string>",
"useCustomInstructions": true
},
"voiceConfig": {
"ttsLabel": "<string>",
"ttsModel": "<string>",
"ttsVendor": "<string>",
"ttsVoice": "<string>",
"ttsDisableCache": true,
"ttsLanguage": "<string>"
}
}
],
"nextCursor": "507f1f77bcf86cd799439011",
"previousCursor": "507f1f77bcf86cd799439011",
"total": 1
}{
"detail": "request body validation failed",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"instance": "/v1/{resource}",
"status": 400,
"title": "Bad Request",
"traceId": "api--a4d2f126-bec4-4544-a049-7c0cf08524ed",
"type": "about:blank"
}{
"detail": "access denied: insufficient permissions",
"instance": "/v1/{resource}/{id}",
"status": 403,
"title": "Forbidden",
"traceId": "api--a4d2f126-bec4-4544-a049-7c0cf08524ed",
"type": "about:blank"
}{
"detail": "internal server error",
"instance": "/v1/{resource}",
"status": 500,
"title": "Internal Server Error",
"traceId": "api--a4d2f126-bec4-4544-a049-7c0cf08524ed",
"type": "about:blank"
}