Skip to contentSkip to navigationSkip to topbar
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 nameTypeRequiredDescriptionChild properties
sip_trunk_domainstringOptional
Not PII

The absolute URL of the SIP Trunk


urlstring<uri>Optional

The absolute URL of the resource.


sidSID<QQ>Optional

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>Optional

The unique SID identifier of the Account.

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

friendly_namestringOptional

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


voice_regionstringOptional

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


date_createdstring<date-time>Optional

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


date_updatedstring<date-time>Optional

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 configurationLink to code sample: Fetch a Trunk's current Inbound Processing Region configuration
1
// Download the helper library from https://www.twilio.com/docs/node/install
2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4
// Find your Account SID and Auth Token at twilio.com/console
5
// and set the environment variables. See http://twil.io/secure
6
const accountSid = process.env.TWILIO_ACCOUNT_SID;
7
const authToken = process.env.TWILIO_AUTH_TOKEN;
8
const client = twilio(accountSid, authToken);
9
10
async function fetchTrunks() {
11
const trunk = await client.routes.v2
12
.trunks("example.pstn.twilio.com")
13
.fetch();
14
15
console.log(trunk.voiceRegion);
16
}
17
18
fetchTrunks();

Output

1
{
2
"sip_trunk_domain": "example.pstn.twilio.com",
3
"url": "https://routes.twilio.com/v2/Trunks/test.pstn.twilio.com",
4
"account_sid": "AC00000000000000000000000000000000",
5
"sid": "QQ00000000000000000000000000000000",
6
"friendly_name": "string",
7
"voice_region": "string",
8
"date_created": "2022-06-02T22:33:47Z",
9
"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

Encoding type:application/x-www-form-urlencoded
SchemaExample
Property nameTypeRequiredDescriptionChild properties
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 configurationLink to code sample: Update a Trunk's Inbound Processing Region configuration
1
// Download the helper library from https://www.twilio.com/docs/node/install
2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4
// Find your Account SID and Auth Token at twilio.com/console
5
// and set the environment variables. See http://twil.io/secure
6
const accountSid = process.env.TWILIO_ACCOUNT_SID;
7
const authToken = process.env.TWILIO_AUTH_TOKEN;
8
const client = twilio(accountSid, authToken);
9
10
async function updateTrunks() {
11
const trunk = await client.routes.v2
12
.trunks("example.pstn.twilio.com")
13
.update({ voiceRegion: "au1" });
14
15
console.log(trunk.voiceRegion);
16
}
17
18
updateTrunks();

Output

1
{
2
"sip_trunk_domain": "example.pstn.twilio.com",
3
"url": "https://routes.twilio.com/v2/Trunks/test.pstn.twilio.com",
4
"sid": "QQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
6
"friendly_name": "friendly_name",
7
"voice_region": "au1",
8
"date_created": "2020-08-07T22:29:24Z",
9
"date_updated": "2020-08-07T22:29:24Z"
10
}

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.