Dialing Permissions - Settings resource

On this reference page, you'll learn about the parameters and properties for the Settings resource, which represents a subaccount's inheritance configurations. See Related how-to documentation to learn the steps to use the info on this page.

DialingPermissions Settings properties

Property nameTypeRequiredPIIDescriptionChild properties

dialingPermissionsInheritanceboolean

Optional

Not PII

true if the sub-account will inherit voice dialing permissions from the Master Project; otherwise false.

urlstring<uri>

Optional

Not PII

The absolute URL of this resource.

Retrieve DialingPermissions Settings

GET https://voice.twilio.com/v1/Settings

Retrieve a DialingPermissions Settings resource

1// Download the helper library from https://www.twilio.com/docs/node/install
2const 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
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function fetchDialingPermissionsSettings() {
11  const setting = await client.voice.v1.dialingPermissions.settings().fetch();
12
13  console.log(setting.dialingPermissionsInheritance);
14}
15
16fetchDialingPermissionsSettings();

Response

1{
2  "dialing_permissions_inheritance": true,
3  "url": "https://voice.twilio.com/v1/Settings"
4}

Update DialingPermissions Settings

POST https://voice.twilio.com/v1/Settings

Request body parameters

Encoding type:application/x-www-form-urlencoded

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

dialingPermissionsInheritanceboolean

Optional

Not PII

true for the sub-account to inherit voice dialing permissions from the Master Project; otherwise false.

Update a DialingPermissions Settings resource

1// Download the helper library from https://www.twilio.com/docs/node/install
2const 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
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function updateDialingPermissionsSettings() {
11  const setting = await client.voice.v1.dialingPermissions
12    .settings()
13    .update({ dialingPermissionsInheritance: false });
14
15  console.log(setting.dialingPermissionsInheritance);
16}
17
18updateDialingPermissionsSettings();

Response

1{
2  "dialing_permissions_inheritance": false,
3  "url": "https://voice.twilio.com/v1/Settings"
4}