---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/voice/api/dialingpermissions-settings-resource#article
headline: Dialing Permissions - Settings resource
description: Full Twilio API reference for the Settings reference resource used to manage subaccount inheritance settings for voice dialing permissions.
url: https://www.twilio.com/docs/voice/api/dialingpermissions-settings-resource
inLanguage: en
dateModified: 2026-06-22T10:15:32.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 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](#related-how-to-documentation) to learn the steps to use the info on this page.

## DialingPermissions Settings properties

<OperationTable type="properties" data={{"type":"object","refName":"voice.v1.dialing_permissions.dialing_permissions_settings","modelName":"voice_v1_dialing_permissions_dialing_permissions_settings","properties":{"dialing_permissions_inheritance":{"type":"boolean","nullable":true,"description":"`true` if the sub-account will inherit voice dialing permissions from the Master Project; otherwise `false`."},"url":{"type":"string","format":"uri","nullable":true,"description":"The absolute URL of this resource."}}}} />

## Retrieve DialingPermissions Settings

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

Retrieve a DialingPermissions Settings resource

```js
// Download the helper library from https://www.twilio.com/docs/node/install
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const apiKey = process.env.TWILIO_API_KEY;
const apiSecret = process.env.TWILIO_API_SECRET;
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

async function fetchDialingPermissionsSettings() {
  const setting = await client.voice.v1.dialingPermissions.settings().fetch();

  console.log(setting.dialingPermissionsInheritance);
}

fetchDialingPermissionsSettings();
```

```python
# Download the helper library from https://www.twilio.com/docs/python/install
import os
from twilio.rest import Client

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = os.environ["TWILIO_API_KEY"]
api_secret = os.environ["TWILIO_API_SECRET"]
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
client = Client(api_key, api_secret, account_sid)

setting = client.voice.v1.dialing_permissions.settings().fetch()

print(setting.dialing_permissions_inheritance)
```

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Voice.V1.DialingPermissions;
using System.Threading.Tasks;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var settings = await SettingsResource.FetchAsync();

        Console.WriteLine(settings.DialingPermissionsInheritance);
    }
}
```

```java
// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.rest.voice.v1.dialingpermissions.Settings;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        Settings settings = Settings.fetcher().fetch();

        System.out.println(settings.getDialingPermissionsInheritance());
    }
}
```

```go
// Download the helper library from https://www.twilio.com/docs/go/install
package main

import (
	"fmt"
	"github.com/twilio/twilio-go"
	"os"
)

func main() {
	// Find your Account SID at twilio.com/console
	// Provision API Keys at twilio.com/console/runtime/api-keys
	// and set the environment variables. See http://twil.io/secure
	// For local testing, you can use your Account SID and Auth token
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
	apiKey := os.Getenv("TWILIO_API_KEY")
	apiSecret := os.Getenv("TWILIO_API_SECRET")
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
		Username:   apiKey,
		Password:   apiSecret,
		AccountSid: accountSid,
	})

	resp, err := client.VoiceV1.FetchDialingPermissionsSettings()
	if err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	} else {
		if resp.DialingPermissionsInheritance != nil {
			fmt.Println(*resp.DialingPermissionsInheritance)
		} else {
			fmt.Println(resp.DialingPermissionsInheritance)
		}
	}
}
```

```php
<?php

// Update the path below to your autoload.php,
// see https://getcomposer.org/doc/01-basic-usage.md
require_once "/path/to/vendor/autoload.php";

use Twilio\Rest\Client;

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
$apiKey = $_ENV["TWILIO_API_KEY"];
$apiSecret = $_ENV["TWILIO_API_SECRET"];
$sid = $_ENV["TWILIO_ACCOUNT_SID"];
$twilio = new Client($apiKey, $apiSecret, $sid);

$setting = $twilio->voice->v1->dialingPermissions->settings()->fetch();

print $setting->dialingPermissionsInheritance;
```

```ruby
# Download the helper library from https://www.twilio.com/docs/ruby/install
require 'twilio-ruby'

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = ENV['TWILIO_API_KEY']
api_secret = ENV['TWILIO_API_SECRET']
account_sid = ENV['TWILIO_ACCOUNT_SID']
@client = Twilio::REST::Client.new(api_key, api_secret, account_sid)

setting = @client
          .voice
          .v1
          .dialing_permissions
          .settings
          .fetch

puts setting.dialing_permissions_inheritance
```

```bash
# Install the twilio-cli from https://twil.io/cli

twilio api:voice:v1:settings:fetch
```

```bash
curl -X GET "https://voice.twilio.com/v1/Settings" \
-u $TWILIO_API_KEY:$TWILIO_API_SECRET
```

```json
{
  "dialing_permissions_inheritance": true,
  "url": "https://voice.twilio.com/v1/Settings"
}
```

## Update DialingPermissions Settings

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

### Request body parameters

```json
{"schema":{"type":"object","title":"UpdateDialingPermissionsSettingsRequest","properties":{"DialingPermissionsInheritance":{"type":"boolean","description":"`true` for the sub-account to inherit voice dialing permissions from the Master Project; otherwise `false`."}}},"examples":{"update":{"value":{"lang":"json","value":"{\n  \"DialingPermissionsInheritance\": true\n}","meta":"","code":"{\n  \"DialingPermissionsInheritance\": true\n}","tokens":[["{","#C9D1D9"],"\n  ",["\"DialingPermissionsInheritance\"","#7EE787"],[":","#C9D1D9"]," ",["true","#79C0FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117","colorScheme":"dark"}}}},"encodingType":"application/x-www-form-urlencoded","conditionalParameterMap":{}}
```

Update a DialingPermissions Settings resource

```js
// Download the helper library from https://www.twilio.com/docs/node/install
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const apiKey = process.env.TWILIO_API_KEY;
const apiSecret = process.env.TWILIO_API_SECRET;
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

async function updateDialingPermissionsSettings() {
  const setting = await client.voice.v1.dialingPermissions
    .settings()
    .update({ dialingPermissionsInheritance: false });

  console.log(setting.dialingPermissionsInheritance);
}

updateDialingPermissionsSettings();
```

```python
# Download the helper library from https://www.twilio.com/docs/python/install
import os
from twilio.rest import Client

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = os.environ["TWILIO_API_KEY"]
api_secret = os.environ["TWILIO_API_SECRET"]
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
client = Client(api_key, api_secret, account_sid)

dialing_permissions_settings = (
    client.voice.v1.dialing_permissions.settings().update(
        dialing_permissions_inheritance=False
    )
)

print(dialing_permissions_settings.dialing_permissions_inheritance)
```

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Voice.V1.DialingPermissions;
using System.Threading.Tasks;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var settings = await SettingsResource.UpdateAsync(dialingPermissionsInheritance: false);

        Console.WriteLine(settings.DialingPermissionsInheritance);
    }
}
```

```java
// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.rest.voice.v1.dialingpermissions.Settings;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        Settings settings = Settings.updater().setDialingPermissionsInheritance(false).update();

        System.out.println(settings.getDialingPermissionsInheritance());
    }
}
```

```go
// Download the helper library from https://www.twilio.com/docs/go/install
package main

import (
	"fmt"
	"github.com/twilio/twilio-go"
	voice "github.com/twilio/twilio-go/rest/voice/v1"
	"os"
)

func main() {
	// Find your Account SID at twilio.com/console
	// Provision API Keys at twilio.com/console/runtime/api-keys
	// and set the environment variables. See http://twil.io/secure
	// For local testing, you can use your Account SID and Auth token
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
	apiKey := os.Getenv("TWILIO_API_KEY")
	apiSecret := os.Getenv("TWILIO_API_SECRET")
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
		Username:   apiKey,
		Password:   apiSecret,
		AccountSid: accountSid,
	})

	params := &voice.UpdateDialingPermissionsSettingsParams{}
	params.SetDialingPermissionsInheritance(false)

	resp, err := client.VoiceV1.UpdateDialingPermissionsSettings(params)
	if err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	} else {
		if resp.DialingPermissionsInheritance != nil {
			fmt.Println(*resp.DialingPermissionsInheritance)
		} else {
			fmt.Println(resp.DialingPermissionsInheritance)
		}
	}
}
```

```php
<?php

// Update the path below to your autoload.php,
// see https://getcomposer.org/doc/01-basic-usage.md
require_once "/path/to/vendor/autoload.php";

use Twilio\Rest\Client;

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
$apiKey = $_ENV["TWILIO_API_KEY"];
$apiSecret = $_ENV["TWILIO_API_SECRET"];
$sid = $_ENV["TWILIO_ACCOUNT_SID"];
$twilio = new Client($apiKey, $apiSecret, $sid);

$dialing_permissions_settings = $twilio->voice->v1->dialingPermissions
    ->settings()
    ->update(["dialingPermissionsInheritance" => false]);

print $dialing_permissions_settings->dialingPermissionsInheritance;
```

```ruby
# Download the helper library from https://www.twilio.com/docs/ruby/install
require 'twilio-ruby'

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = ENV['TWILIO_API_KEY']
api_secret = ENV['TWILIO_API_SECRET']
account_sid = ENV['TWILIO_ACCOUNT_SID']
@client = Twilio::REST::Client.new(api_key, api_secret, account_sid)

setting = @client
          .voice
          .v1
          .dialing_permissions
          .settings
          .update(dialing_permissions_inheritance: false)

puts setting.dialing_permissions_inheritance
```

```bash
# Install the twilio-cli from https://twil.io/cli

twilio api:voice:v1:settings:update
```

```bash
curl -X POST "https://voice.twilio.com/v1/Settings" \
--data-urlencode "DialingPermissionsInheritance=false" \
-u $TWILIO_API_KEY:$TWILIO_API_SECRET
```

```json
{
  "dialing_permissions_inheritance": false,
  "url": "https://voice.twilio.com/v1/Settings"
}
```

## Related how-to documentation

Find how-to documentation for the topics on this page.

* [Make Twilio API requests](/docs/usage/requests-to-twilio)
  * To learn more about this API, see the [Programmable Voice API overview](/docs/voice/api)
  * To learn more about these resources, see the [Dialing Permissions overview](/docs/voice/api/dialing-permissions-resources)