Get all agent groups for the authenticated organization
curl --request GET \
--url https://api.callers.ai/agent-groups \
--header 'Authorization: <api-key>'import requests
url = "https://api.callers.ai/agent-groups"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.callers.ai/agent-groups', 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.callers.ai/agent-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <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.callers.ai/agent-groups"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<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.callers.ai/agent-groups")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.callers.ai/agent-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "507f1f77bcf86cd799439011",
"name": "Onboarding Campaigns",
"organizationId": "507f1f77bcf86cd799439012",
"campaignsCount": 3,
"createdAt": "2024-04-09T12:00:00.000Z",
"updatedAt": "2024-04-09T13:30:00.000Z"
}
]Agent Groups
Get all agent groups for the authenticated organization
Returns every agent group that belongs to the organization derived from the API key, each enriched with the number of agents currently assigned to it.
GET
/
agent-groups
Get all agent groups for the authenticated organization
curl --request GET \
--url https://api.callers.ai/agent-groups \
--header 'Authorization: <api-key>'import requests
url = "https://api.callers.ai/agent-groups"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.callers.ai/agent-groups', 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.callers.ai/agent-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <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.callers.ai/agent-groups"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<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.callers.ai/agent-groups")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.callers.ai/agent-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "507f1f77bcf86cd799439011",
"name": "Onboarding Campaigns",
"organizationId": "507f1f77bcf86cd799439012",
"campaignsCount": 3,
"createdAt": "2024-04-09T12:00:00.000Z",
"updatedAt": "2024-04-09T13:30:00.000Z"
}
]Authorizations
Headers
Optional sub organization ID. Must belong to your main organization API key.
Response
200 - application/json
Unique identifier for the agent group. String representation of an ObjectId.
Example:
"507f1f77bcf86cd799439011"
Display name of the agent group.
Example:
"Onboarding Campaigns"
Id of the organization this agent group belongs to. String representation of an ObjectId.
Example:
"507f1f77bcf86cd799439012"
Number of agents currently assigned to this agent group.
Example:
3
Timestamp when the agent group was created (ISO 8601 string).
Example:
"2024-04-09T12:00:00.000Z"
Timestamp when the agent group was last updated (ISO 8601 string).
Example:
"2024-04-09T13:30:00.000Z"