Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Inbound Processing Region API - Trunk


In the context of the Inbound Processing Region API, a Trunk resource represents the routing configuration for a particular Elastic SIP Trunk.

By adjusting the value of the voice_region property, you can control which Twilio Region will process and store data related to inbound calls for the Trunk.

(warning)

Warning

Changes to this resource may take up to 5 minutes to take effect.


Trunk properties

trunk-properties page anchor
Property nameTypePIIDescription
sip_trunk_domainstring
Not PII

The absolute URL of the SIP Trunk


urlstring<uri>

The absolute URL of the resource.


sidSID<QQ>

A 34 character string that uniquely identifies the Inbound Processing Region assignments for this SIP Trunk.

Pattern: ^QQ[0-9a-fA-F]{32}$Min length: 34Max length: 34

account_sidSID<AC>

The unique SID identifier of the Account.

Pattern: ^AC[0-9a-fA-F]{32}$Min length: 34Max length: 34

friendly_namestring

A human readable description of the Inbound Processing Region assignments for this SIP Trunk, up to 64 characters.


voice_regionstring

The Inbound Processing Region used for this SIP Trunk for voice.


date_createdstring<date-time>

The date that this SIP Trunk was assigned an Inbound Processing Region, given in ISO 8601 format.


date_updatedstring<date-time>

The date that the Inbound Processing Region was updated for this SIP Trunk, given in ISO 8601 format.


Fetch a Trunk's current Inbound Processing Region configuration

fetch-a-trunks-current-inbound-processing-region-configuration page anchor
GET https://routes.twilio.com/v2/Trunks/{SipTrunkDomain}

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
SipTrunkDomainstringrequired

The absolute URL of the SIP Trunk

Fetch a Trunk's current Inbound Processing Region configuration

fetch-a-trunks-current-inbound-processing-region-configuration-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18
_18
// Find your Account SID and Auth Token at twilio.com/console
_18
// and set the environment variables. See http://twil.io/secure
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function fetchTrunks() {
_18
const trunk = await client.routes.v2
_18
.trunks("example.pstn.twilio.com")
_18
.fetch();
_18
_18
console.log(trunk.voiceRegion);
_18
}
_18
_18
fetchTrunks();

Output

_10
{
_10
"sip_trunk_domain": "example.pstn.twilio.com",
_10
"url": "https://routes.twilio.com/v2/Trunks/test.pstn.twilio.com",
_10
"account_sid": "AC00000000000000000000000000000000",
_10
"sid": "QQ00000000000000000000000000000000",
_10
"friendly_name": "string",
_10
"voice_region": "string",
_10
"date_created": "2022-06-02T22:33:47Z",
_10
"date_updated": "2022-06-02T22:33:47Z"
_10
}


Update a Trunk's Inbound Processing Region configuration

update-a-trunks-inbound-processing-region-configuration page anchor
POST https://routes.twilio.com/v2/Trunks/{SipTrunkDomain}

Property nameTypeRequiredPIIDescription
SipTrunkDomainstringrequired

The absolute URL of the SIP Trunk

Property nameTypeRequiredPIIDescription
VoiceRegionstringOptional

The Inbound Processing Region used for this SIP Trunk for voice


FriendlyNamestringOptional

A human readable description of this resource, up to 64 characters.

Update a Trunk's Inbound Processing Region configuration

update-a-trunks-inbound-processing-region-configuration-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18
_18
// Find your Account SID and Auth Token at twilio.com/console
_18
// and set the environment variables. See http://twil.io/secure
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function updateTrunks() {
_18
const trunk = await client.routes.v2
_18
.trunks("example.pstn.twilio.com")
_18
.update({ voiceRegion: "au1" });
_18
_18
console.log(trunk.voiceRegion);
_18
}
_18
_18
updateTrunks();

Output

_10
{
_10
"sip_trunk_domain": "example.pstn.twilio.com",
_10
"url": "https://routes.twilio.com/v2/Trunks/test.pstn.twilio.com",
_10
"sid": "QQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10
"friendly_name": "friendly_name",
_10
"voice_region": "au1",
_10
"date_created": "2020-08-07T22:29:24Z",
_10
"date_updated": "2020-08-07T22:29:24Z"
_10
}


Rate this page: