Add Dispositions to Group
curl --request POST \
--url https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"dispositions": [
{}
]
}
'import requests
url = "https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions"
payload = { "dispositions": [{}] }
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({dispositions: [{}]})
};
fetch('https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions', 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.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions",
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([
'dispositions' => [
[
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json"
],
]);
$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.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions"
payload := strings.NewReader("{\n \"dispositions\": [\n {}\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
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.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"dispositions\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dispositions\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Dispositions added to group successfully"
}
{
"success": false,
"message": "dispositions must be a non-empty array"
}
{
"success": false,
"message": "Invalid disposition IDs",
"invalidIds": ["invalidId123"]
}
{
"success": false,
"message": "Disposition group not found"
}
{
"success": false,
"error": "Unauthorized",
"message": "Missing or invalid authorization header"
}
{
"success": false,
"error": "Forbidden",
"message": "You don't have the required permission to perform this action"
}
{
"success": false,
"error": "InternalServerError",
"message": "An unexpected error occurred"
}
Dispositions Group
Add Dispositions to Group
Add dispositions to an existing group
Add Dispositions to Group
curl --request POST \
--url https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"dispositions": [
{}
]
}
'import requests
url = "https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions"
payload = { "dispositions": [{}] }
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({dispositions: [{}]})
};
fetch('https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions', 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.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions",
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([
'dispositions' => [
[
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: application/json"
],
]);
$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.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions"
payload := strings.NewReader("{\n \"dispositions\": [\n {}\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
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.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions")
.header("Authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"dispositions\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.agents.timepay.ai/api/v1/dispositions/groups/{id}/dispositions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"dispositions\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Dispositions added to group successfully"
}
{
"success": false,
"message": "dispositions must be a non-empty array"
}
{
"success": false,
"message": "Invalid disposition IDs",
"invalidIds": ["invalidId123"]
}
{
"success": false,
"message": "Disposition group not found"
}
{
"success": false,
"error": "Unauthorized",
"message": "Missing or invalid authorization header"
}
{
"success": false,
"error": "Forbidden",
"message": "You don't have the required permission to perform this action"
}
{
"success": false,
"error": "InternalServerError",
"message": "An unexpected error occurred"
}
Overview
Add one or more dispositions to an existing disposition group. This is useful for incrementally building up a group without replacing the entire disposition list.Duplicate disposition IDs are automatically ignored. If a disposition is already in the group, it won’t be added again.
Headers
string
required
Bearer token for authentication (e.g.,
Bearer <your_token>).Path Parameters
string
required
The unique identifier of the disposition group
Request Body
array
required
Array of disposition IDs to add to the group
Response
boolean
Indicates if the request was successful
string
Response message
{
"success": true,
"message": "Dispositions added to group successfully"
}
{
"success": false,
"message": "dispositions must be a non-empty array"
}
{
"success": false,
"message": "Invalid disposition IDs",
"invalidIds": ["invalidId123"]
}
{
"success": false,
"message": "Disposition group not found"
}
{
"success": false,
"error": "Unauthorized",
"message": "Missing or invalid authorization header"
}
{
"success": false,
"error": "Forbidden",
"message": "You don't have the required permission to perform this action"
}
{
"success": false,
"error": "InternalServerError",
"message": "An unexpected error occurred"
}
Error Codes
| Status | Description |
|---|---|
400 | Empty array or invalid disposition IDs |
401 | Unauthorized - Invalid or missing API key |
403 | Forbidden - Missing required permissions |
404 | Disposition group not found |
500 | Internal server error |

