curl --request PUT \
--url https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expected_version": 1,
"enabled": true,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "platform",
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true
},
"ring_group": {
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
},
"activate_carrier_route": false,
"rollback_carrier_route": false,
"carrier_operation_id": "<string>"
}
'import requests
url = "https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding"
payload = {
"expected_version": 1,
"enabled": True,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "platform",
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": True
},
"ring_group": {
"desktop_endpoint_ids": ["<string>"],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": True
},
"activate_carrier_route": False,
"rollback_carrier_route": False,
"carrier_operation_id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expected_version: 1,
enabled: true,
project_id: '<string>',
agent_id: '<string>',
agent_release_id: '<string>',
agent_profile_sha256: '<string>',
admission_mode: 'platform',
forward: {to: '<string>', max_duration_seconds: 1815, recording: true},
ring_group: {
desktop_endpoint_ids: ['<string>'],
external_to: '<string>',
desktop_timeout_seconds: 17,
ring_timeout_seconds: 35,
on_no_answer: 'hangup',
max_duration_seconds: 1815,
recording: true
},
activate_carrier_route: false,
rollback_carrier_route: false,
carrier_operation_id: '<string>'
})
};
fetch('https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding', 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.pyai.com/v1/telephony/numbers/{id}/inbound-binding",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'expected_version' => 1,
'enabled' => true,
'project_id' => '<string>',
'agent_id' => '<string>',
'agent_release_id' => '<string>',
'agent_profile_sha256' => '<string>',
'admission_mode' => 'platform',
'forward' => [
'to' => '<string>',
'max_duration_seconds' => 1815,
'recording' => true
],
'ring_group' => [
'desktop_endpoint_ids' => [
'<string>'
],
'external_to' => '<string>',
'desktop_timeout_seconds' => 17,
'ring_timeout_seconds' => 35,
'on_no_answer' => 'hangup',
'max_duration_seconds' => 1815,
'recording' => true
],
'activate_carrier_route' => false,
'rollback_carrier_route' => false,
'carrier_operation_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.pyai.com/v1/telephony/numbers/{id}/inbound-binding"
payload := strings.NewReader("{\n \"expected_version\": 1,\n \"enabled\": true,\n \"project_id\": \"<string>\",\n \"agent_id\": \"<string>\",\n \"agent_release_id\": \"<string>\",\n \"agent_profile_sha256\": \"<string>\",\n \"admission_mode\": \"platform\",\n \"forward\": {\n \"to\": \"<string>\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"ring_group\": {\n \"desktop_endpoint_ids\": [\n \"<string>\"\n ],\n \"external_to\": \"<string>\",\n \"desktop_timeout_seconds\": 17,\n \"ring_timeout_seconds\": 35,\n \"on_no_answer\": \"hangup\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"activate_carrier_route\": false,\n \"rollback_carrier_route\": false,\n \"carrier_operation_id\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expected_version\": 1,\n \"enabled\": true,\n \"project_id\": \"<string>\",\n \"agent_id\": \"<string>\",\n \"agent_release_id\": \"<string>\",\n \"agent_profile_sha256\": \"<string>\",\n \"admission_mode\": \"platform\",\n \"forward\": {\n \"to\": \"<string>\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"ring_group\": {\n \"desktop_endpoint_ids\": [\n \"<string>\"\n ],\n \"external_to\": \"<string>\",\n \"desktop_timeout_seconds\": 17,\n \"ring_timeout_seconds\": 35,\n \"on_no_answer\": \"hangup\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"activate_carrier_route\": false,\n \"rollback_carrier_route\": false,\n \"carrier_operation_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expected_version\": 1,\n \"enabled\": true,\n \"project_id\": \"<string>\",\n \"agent_id\": \"<string>\",\n \"agent_release_id\": \"<string>\",\n \"agent_profile_sha256\": \"<string>\",\n \"admission_mode\": \"platform\",\n \"forward\": {\n \"to\": \"<string>\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"ring_group\": {\n \"desktop_endpoint_ids\": [\n \"<string>\"\n ],\n \"external_to\": \"<string>\",\n \"desktop_timeout_seconds\": 17,\n \"ring_timeout_seconds\": 35,\n \"on_no_answer\": \"hangup\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"activate_carrier_route\": false,\n \"rollback_carrier_route\": false,\n \"carrier_operation_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"object": "telephony.inbound_binding",
"number_id": "<string>",
"version": 1,
"enabled": true,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
},
"admission_mode": "client",
"carrier_operation": {
"id": "<string>",
"phase": "pending",
"revision": 2,
"request_sha256": "<string>",
"prior_route_sha256": "<string>",
"desired_route_sha256": "<string>",
"expected_version": 1,
"desired_binding": {
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "client",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
}
},
"rollback_expected_version": 1
}
}{
"object": "telephony.inbound_binding",
"number_id": "<string>",
"version": 1,
"enabled": true,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
},
"admission_mode": "client",
"carrier_operation": {
"id": "<string>",
"phase": "pending",
"revision": 2,
"request_sha256": "<string>",
"prior_route_sha256": "<string>",
"desired_route_sha256": "<string>",
"expected_version": 1,
"desired_binding": {
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "client",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
}
},
"rollback_expected_version": 1
}
}{
"title": "<string>",
"status": 123,
"type": "<string>",
"detail": "<string>",
"request_id": "<string>"
}{
"title": "<string>",
"status": 123,
"type": "<string>",
"detail": "<string>",
"request_id": "<string>"
}Set an explicit managed inbound binding
Compare-and-swap the number binding with expected_version (initially 0). Enable with project_id, agent_id, agent_release_id and agent_profile_sha256: SHA-256 of recursively key-sorted JSON for the full public Agent GET resource (array order retained). The profile must have no greeting variants or business tools. Explicit indexed knowledge requires agent_knowledge_receipt with exact owned document/source/index digests; organization inheritance and hidden context remain unsupported. The receipt is frozen with the binding and rechecked before answer and media admission. admission_mode=client waits up to 12 seconds before answer; platform accepts with a 120-second cap. Ordinary connected-number binding only reads already canonical carrier routing. Explicit activate_carrier_route=true with a stable carrier_operation_id captures encrypted prior routing before changing only this verified-owned carrier number’s voice/status callbacks. Pending/unknown operations return 202, block new admissions and must be resumed with the same original request; GET exposes the immutable desired binding and original expected_version. Roll back with enabled=false, rollback_carrier_route=true, the same operation ID and current expected_version; routing is restored only if it still matches the operation’s captured desired or prior hash. External drift is held unknown without overwrite. Existing admitted calls retain frozen authority. Set forward.menu.kind=keypad to save a spoken single-digit menu instead of forward.to. The number’s menu capability is checked before saving or changing routing; unsupported numbers return unsupported_route. One attempt offers up to nine saved choices. Invalid input hangs up; an empty result uses timeout_choice_id or hangs up when null. A caller-bound callback freezes one selection before the ordinary target consent, country and capacity checks or dialing. Menu audio is not recorded; both recording notices run before forwarding connects. The original total call deadline stays fixed, and retries cannot change the saved prompt or selection or dial another target. Optional forward explicitly selects human forwarding on the registered switch instead of AI: the published profile remains pinned, target consent/country/capacity is checked before the sole target dispatch, and the original caller owns recording. This mode uses platform admission and a 30–3600 second absolute deadline; omitted/null forward retains AI behavior. No number acquisition occurs.
curl --request PUT \
--url https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expected_version": 1,
"enabled": true,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "platform",
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true
},
"ring_group": {
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
},
"activate_carrier_route": false,
"rollback_carrier_route": false,
"carrier_operation_id": "<string>"
}
'import requests
url = "https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding"
payload = {
"expected_version": 1,
"enabled": True,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "platform",
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": True
},
"ring_group": {
"desktop_endpoint_ids": ["<string>"],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": True
},
"activate_carrier_route": False,
"rollback_carrier_route": False,
"carrier_operation_id": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expected_version: 1,
enabled: true,
project_id: '<string>',
agent_id: '<string>',
agent_release_id: '<string>',
agent_profile_sha256: '<string>',
admission_mode: 'platform',
forward: {to: '<string>', max_duration_seconds: 1815, recording: true},
ring_group: {
desktop_endpoint_ids: ['<string>'],
external_to: '<string>',
desktop_timeout_seconds: 17,
ring_timeout_seconds: 35,
on_no_answer: 'hangup',
max_duration_seconds: 1815,
recording: true
},
activate_carrier_route: false,
rollback_carrier_route: false,
carrier_operation_id: '<string>'
})
};
fetch('https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding', 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.pyai.com/v1/telephony/numbers/{id}/inbound-binding",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'expected_version' => 1,
'enabled' => true,
'project_id' => '<string>',
'agent_id' => '<string>',
'agent_release_id' => '<string>',
'agent_profile_sha256' => '<string>',
'admission_mode' => 'platform',
'forward' => [
'to' => '<string>',
'max_duration_seconds' => 1815,
'recording' => true
],
'ring_group' => [
'desktop_endpoint_ids' => [
'<string>'
],
'external_to' => '<string>',
'desktop_timeout_seconds' => 17,
'ring_timeout_seconds' => 35,
'on_no_answer' => 'hangup',
'max_duration_seconds' => 1815,
'recording' => true
],
'activate_carrier_route' => false,
'rollback_carrier_route' => false,
'carrier_operation_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.pyai.com/v1/telephony/numbers/{id}/inbound-binding"
payload := strings.NewReader("{\n \"expected_version\": 1,\n \"enabled\": true,\n \"project_id\": \"<string>\",\n \"agent_id\": \"<string>\",\n \"agent_release_id\": \"<string>\",\n \"agent_profile_sha256\": \"<string>\",\n \"admission_mode\": \"platform\",\n \"forward\": {\n \"to\": \"<string>\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"ring_group\": {\n \"desktop_endpoint_ids\": [\n \"<string>\"\n ],\n \"external_to\": \"<string>\",\n \"desktop_timeout_seconds\": 17,\n \"ring_timeout_seconds\": 35,\n \"on_no_answer\": \"hangup\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"activate_carrier_route\": false,\n \"rollback_carrier_route\": false,\n \"carrier_operation_id\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.put("https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expected_version\": 1,\n \"enabled\": true,\n \"project_id\": \"<string>\",\n \"agent_id\": \"<string>\",\n \"agent_release_id\": \"<string>\",\n \"agent_profile_sha256\": \"<string>\",\n \"admission_mode\": \"platform\",\n \"forward\": {\n \"to\": \"<string>\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"ring_group\": {\n \"desktop_endpoint_ids\": [\n \"<string>\"\n ],\n \"external_to\": \"<string>\",\n \"desktop_timeout_seconds\": 17,\n \"ring_timeout_seconds\": 35,\n \"on_no_answer\": \"hangup\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"activate_carrier_route\": false,\n \"rollback_carrier_route\": false,\n \"carrier_operation_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pyai.com/v1/telephony/numbers/{id}/inbound-binding")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expected_version\": 1,\n \"enabled\": true,\n \"project_id\": \"<string>\",\n \"agent_id\": \"<string>\",\n \"agent_release_id\": \"<string>\",\n \"agent_profile_sha256\": \"<string>\",\n \"admission_mode\": \"platform\",\n \"forward\": {\n \"to\": \"<string>\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"ring_group\": {\n \"desktop_endpoint_ids\": [\n \"<string>\"\n ],\n \"external_to\": \"<string>\",\n \"desktop_timeout_seconds\": 17,\n \"ring_timeout_seconds\": 35,\n \"on_no_answer\": \"hangup\",\n \"max_duration_seconds\": 1815,\n \"recording\": true\n },\n \"activate_carrier_route\": false,\n \"rollback_carrier_route\": false,\n \"carrier_operation_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"object": "telephony.inbound_binding",
"number_id": "<string>",
"version": 1,
"enabled": true,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
},
"admission_mode": "client",
"carrier_operation": {
"id": "<string>",
"phase": "pending",
"revision": 2,
"request_sha256": "<string>",
"prior_route_sha256": "<string>",
"desired_route_sha256": "<string>",
"expected_version": 1,
"desired_binding": {
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "client",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
}
},
"rollback_expected_version": 1
}
}{
"object": "telephony.inbound_binding",
"number_id": "<string>",
"version": 1,
"enabled": true,
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
},
"admission_mode": "client",
"carrier_operation": {
"id": "<string>",
"phase": "pending",
"revision": 2,
"request_sha256": "<string>",
"prior_route_sha256": "<string>",
"desired_route_sha256": "<string>",
"expected_version": 1,
"desired_binding": {
"project_id": "<string>",
"agent_id": "<string>",
"agent_release_id": "<string>",
"agent_profile_sha256": "<string>",
"admission_mode": "client",
"agent_knowledge_receipt": {
"version": 1,
"kb_id": "<string>",
"documents": [
{
"document_id": "<string>",
"source_sha256": "<string>",
"chunks_sha256": "<string>",
"chunks": 100
}
]
},
"forward": {
"to": "<string>",
"max_duration_seconds": 1815,
"recording": true,
"menu": {
"kind": "keypad",
"prompt": "<string>",
"choices": [
{
"id": "<string>",
"key": "<string>",
"to": "<string>"
}
],
"timeout_seconds": 5,
"timeout_choice_id": "<string>"
}
},
"ring_group": {
"mode": "simultaneous",
"desktop_endpoint_ids": [
"<string>"
],
"external_to": "<string>",
"desktop_timeout_seconds": 17,
"ring_timeout_seconds": 35,
"on_no_answer": "hangup",
"max_duration_seconds": 1815,
"recording": true
}
},
"rollback_expected_version": 1
}
}{
"title": "<string>",
"status": 123,
"type": "<string>",
"detail": "<string>",
"request_id": "<string>"
}{
"title": "<string>",
"status": 123,
"type": "<string>",
"detail": "<string>",
"request_id": "<string>"
}Authorizations
Body
One registered app desktop and one authorized external recipient. Choose simultaneous or desktop-first ringing. The total ring window and absolute original call deadline never reset on fallback. A registered but offline desktop is skipped. Only hangup on no answer is supported. Mutually exclusive with forward; null restores the explicitly supplied AI admission_mode without changing the original carrier activation.
Show child attributes
Show child attributes
Response
Saved binding
One registered app desktop and one authorized external recipient. Choose simultaneous or desktop-first ringing. The total ring window and absolute original call deadline never reset on fallback. A registered but offline desktop is skipped. Only hangup on no answer is supported. Mutually exclusive with forward; null restores the explicitly supplied AI admission_mode without changing the original carrier activation.
Show child attributes
Show child attributes