Skip to main content
POST
/
v1.0
/
voice
/
routes
/
update
json
{
  "CallRouteId": "CRID-509de94f-79cc-429b-a317-2102654dabbb",
  "RouteName": "Main SIP Trunk",
  "RouteType": "Trunk",
  "VoiceUrl": "https://domain.com",
  "VoiceUrlMethod": "GET",
  "VoiceAuthenticationType": "Basic",
  "VoiceUsername": "admin",
  "VoicePasswordToken": "passwordORbearerToken",
  "CallbackVoiceUrl": "https://apiendpoint.com",
  "CallbackVoiceUrlMethod": "POST",
  "TrunkIp1": "20.87.87.87",
  "TrunkIp2": "20.87.87.86",
  "TrunkPort1": "5061",
  "TrunkPort2": "5060",
  "TrunkTransport1": "UDP",
  "TrunkTransport2": "TCP",
  "TrunkUri1": "https://pstn.joonto.com",
  "TrunkUri2": "https://pstn2.joonto.com",
  "TrunkEnabled1": true,
  "TrunkEnabled2": false,
  "Trunk1Priortiy": 10,
  "Trunk1Weight": 10,
  "Trunk2Priortiy": 20,
  "Trunk2Weight": 20,
  "HeaderManipulation": "HMI8802029",
  "EnableSipRefer": true,
  "TransferCallerId": "Transferee/Transferor",
  "SymmetricRtp": true,
  "EnableTrpSecureTrunk": true,
  "EnablePstnTransfer": true,
  "IpWhitelist": [{"IpAddress": "20.20.10.10"}, {"IpAddress": "20.20.10.20"}],
  "CnamLookup": true,
  "TerminationUriSubdomain": "client",
  "EnableCallStreaming": true,
  "WssUri": "wss://192.67.88.2",
  "IntelligentRouteEnabled": true,
  "RouteEnabled": true
}
{
  "CallRouteId": "CRID-509de94f-79cc-429b-a317-2102654dabbb",
  "AccountId": "DID-1e8939ab-3f3c-4db1-89d7-956d80fd793j",
  "RouteName": "Main SIP Trunk",
  "RouteType": "Trunk",
  "VoiceUrl": "https://domain.com",
  "VoiceUrlMethod": "GET",
  "TrunkIp1": "20.87.87.87",
  "TrunkIp2": "20.87.87.86",
  "TrunkPort1": "5061",
  "TrunkPort2": "5060",
  "TrunkTransport1": "UDP",
  "TrunkTransport2": "TCP",
  "TrunkUri1": "https://pstn.joonto.com",
  "TrunkUri2": "https://pstn2.joonto.com",
  "TrunkEnabled1": true,
  "TrunkEnabled2": false,
  "Trunk1Priortiy": 10,
  "Trunk1Weight": 10,
  "Trunk2Priortiy": 20,
  "Trunk2Weight": 20,
  "HeaderManipulation": "HMI8802029",
  "EnableSipRefer": true,
  "TransferCallerId": "Transferee/Transferor",
  "SymmetricRtp": true,
  "EnableTrpSecureTrunk": true,
  "EnablePstnTransfer": true,
  "CnamLookup": true,
  "TerminationUriSubdomain": "client",
  "EnableCallStreaming": true,
  "WssUri": "wss://192.67.88.2",
  "IpWhiteList": []
}

Authorizations

​
Authorization
string
header
required

Enter the token obtained from the Authentication endpoint

Body

application/json
​
CallRouteId
string
required

Call Route ID to update (CRID) - Required

Example:

"CRID-509de94f-79cc-429b-a317-2102654dabbb"

​
RouteName
string

Friendly name for voice route

Example:

"Main SIP Trunk"

​
RouteType
enum<string>

Type of voice routing

Available options:
Trunk,
URL,
Forward
Example:

"Trunk"

​
VoiceUrl
string<uri>
Example:

"https://domain.com"

​
VoiceUrlMethod
enum<string>
Available options:
GET,
POST
Example:

"GET"

​
TrunkIp1
string
Example:

"20.87.87.87"

​
TrunkIp2
string
Example:

"20.87.87.86"

​
TrunkPort1
string
Example:

"5061"

​
TrunkPort2
string
Example:

"5060"

​
TrunkTransport1
enum<string>
Available options:
UDP,
TCP,
TLS
Example:

"UDP"

​
TrunkTransport2
enum<string>
Available options:
UDP,
TCP,
TLS
Example:

"TCP"

​
TrunkEnabled1
boolean
Example:

true

​
TrunkEnabled2
boolean
Example:

false

​
RouteEnabled
boolean
Example:

true

​
VoiceAuthenticationType
enum<string>

Authentication type for voice URL

Available options:
Basic,
Bearer
Example:

"Basic"

​
VoiceUsername
string

Username for voice URL authentication

Example:

"admin"

​
VoicePasswordToken
string

Password or bearer token for voice URL authentication

Example:

"passwordORbearerToken"

​
CallbackVoiceUrl
string<uri>

Callback URL for voice events

Example:

"https://apiendpoint.com"

​
CallbackVoiceUrlMethod
enum<string>

HTTP method for callback voice URL

Available options:
GET,
POST
Example:

"POST"

​
TrunkUri1
string<uri>

URI for primary SIP trunk

Example:

"https://pstn.joonto.com"

​
TrunkUri2
string<uri>

URI for secondary SIP trunk

Example:

"https://pstn2.joonto.com"

​
Trunk1Priortiy
integer

Priority for primary trunk (lower = higher priority)

Example:

10

​
Trunk1Weight
integer

Weight for primary trunk load balancing

Example:

10

​
Trunk2Priortiy
integer

Priority for secondary trunk (lower = higher priority)

Example:

20

​
Trunk2Weight
integer

Weight for secondary trunk load balancing

Example:

20

​
HeaderManipulation
string

Header manipulation rule identifier

Example:

"HMI8802029"

​
EnableSipRefer
boolean

Enable SIP REFER for call transfers

Example:

true

​
TransferCallerId
enum<string>

Caller ID to use for transferred calls

Available options:
Transferee,
Transferor,
Transferee/Transferor
Example:

"Transferee/Transferor"

​
SymmetricRtp
boolean

Enable symmetric RTP for NAT traversal

Example:

true

​
EnableTrpSecureTrunk
boolean

Enable TLS/SRTP for secure trunk communication

Example:

true

​
EnablePstnTransfer
boolean

Enable PSTN call transfers

Example:

true

​
IpWhitelist
object[]

List of whitelisted IP addresses

Example:
[
  { "IpAddress": "20.20.10.10" },
  { "IpAddress": "20.20.10.20" }
]
​
CnamLookup
boolean

Enable CNAM lookup for caller ID name

Example:

true

​
TerminationUriSubdomain
string

Subdomain for SIP termination URI

Example:

"client"

​
EnableCallStreaming
boolean

Enable real-time call audio streaming

Example:

true

​
WssUri
string<uri>

WebSocket Secure URI for call streaming

Example:

"wss://192.67.88.2"

​
IntelligentRouteEnabled
boolean

Enable intelligent routing features

Example:

true

Response

200 - application/json

Update Voice Route

The response is of type object.