Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM
Accelerate development with AI
On this page
Looking for more inspiration?Visit the

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

dialingpermissions-settings-properties page anchor
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

retrieve-dialingpermissions-settings page anchor

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

Retrieve a DialingPermissions Settings resourceLink to code sample: Retrieve a DialingPermissions Settings resource
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 at twilio.com/console

5
// Provision API Keys at twilio.com/console/runtime/api-keys

6
// and set the environment variables. See http://twil.io/secure

7
// For local testing, you can use your Account SID and Auth token

8
const accountSid = process.env.TWILIO_ACCOUNT_SID;

9
const apiKey = process.env.TWILIO_API_KEY;

10
const apiSecret = process.env.TWILIO_API_SECRET;

11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

12


13
async function fetchDialingPermissionsSettings() {

14
  const setting = await client.voice.v1.dialingPermissions.settings().fetch();

15


16
  console.log(setting.dialingPermissionsInheritance);

17
}

18


19
fetchDialingPermissionsSettings();

Response

Note about this response
1
{

2
  "dialing_permissions_inheritance": true,

3
  "url": "https://voice.twilio.com/v1/Settings"

4
}

Update DialingPermissions Settings

update-dialingpermissions-settings page anchor

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

Request body parameters

request-body-parameters page anchor
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 resourceLink to code sample: Update a DialingPermissions Settings resource
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 at twilio.com/console

5
// Provision API Keys at twilio.com/console/runtime/api-keys

6
// and set the environment variables. See http://twil.io/secure

7
// For local testing, you can use your Account SID and Auth token

8
const accountSid = process.env.TWILIO_ACCOUNT_SID;

9
const apiKey = process.env.TWILIO_API_KEY;

10
const apiSecret = process.env.TWILIO_API_SECRET;

11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

12


13
async function updateDialingPermissionsSettings() {

14
  const setting = await client.voice.v1.dialingPermissions

15
    .settings()

16
    .update({ dialingPermissionsInheritance: false });

17


18
  console.log(setting.dialingPermissionsInheritance);

19
}

20


21
updateDialingPermissionsSettings();

Response

Note about this response
1
{

2
  "dialing_permissions_inheritance": false,

3
  "url": "https://voice.twilio.com/v1/Settings"

4
}