Voice Insights Settings Resource

Voice Insights Settings determine whether

Advanced Features and/or
Voice Trace

are activated for a given account.

Using the Voice Insights Settings Resource, you can

for an account or a specific subaccount.

Voice Insight Settings properties

Property nameTypeRequiredDescriptionChild properties

account_sidSID<AC>Optional

Not PII

The unique SID identifier of the Account.

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

advanced_featuresbooleanOptional

Not PII

A boolean flag indicating whether Advanced Features for Voice Insights are enabled.

voice_tracebooleanOptional

Not PII

A boolean flag indicating whether Voice Trace is enabled.

urlstring<uri>Optional

Not PII

The URL of this resource.

Get the Voice Insights Settings

GET https://insights.twilio.com/v1/Voice/Settings

Query parameters

Property nameTypeRequiredPIIDescription

SubaccountSidSID<AC>Optional

Not PII

The unique SID identifier of the Subaccount.

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

Get the Voice Insights Settings for the account

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_16// Download the helper library from https://www.twilio.com/docs/node/install
_16const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_16
_16// Find your Account SID and Auth Token at twilio.com/console
_16// and set the environment variables. See http://twil.io/secure
_16const accountSid = process.env.TWILIO_ACCOUNT_SID;
_16const authToken = process.env.TWILIO_AUTH_TOKEN;
_16const client = twilio(accountSid, authToken);
_16
_16async function fetchAccountSettings() {
_16  const setting = await client.insights.v1.settings().fetch();
_16
_16  console.log(setting.accountSid);
_16}
_16
_16fetchAccountSettings();

Output


_10{
_10  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "voice_trace": true,
_10  "advanced_features": true,
_10  "url": "https://insights.twilio.com/v1/Voice/Settings"
_10}

Update Voice Insights Settings

POST https://insights.twilio.com/v1/Voice/Settings

To manage subaccount Settings pass the subaccount SID as a parameter in the request.

Request body parameters

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

SchemaExample

Property nameTypeRequiredDescriptionChild properties

AdvancedFeaturesbooleanOptional

Not PII

A boolean flag to enable Advanced Features for Voice Insights.

VoiceTracebooleanOptional

Not PII

A boolean flag to enable Voice Trace.

SubaccountSidSID<AC>Optional

Not PII

The unique SID identifier of the Subaccount.

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

Update Settings to activate Advanced Features for the account

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_18// Download the helper library from https://www.twilio.com/docs/node/install
_18const 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
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = twilio(accountSid, authToken);
_18
_18async function updateAccountSettings() {
_18  const setting = await client.insights.v1
_18    .settings()
_18    .update({ advancedFeatures: true });
_18
_18  console.log(setting.accountSid);
_18}
_18
_18updateAccountSettings();

Output


_10{
_10  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "voice_trace": true,
_10  "advanced_features": true,
_10  "url": "https://insights.twilio.com/v1/Voice/Settings"
_10}

Update Settings to activate Voice Trace for a subaccount

Node.js

Python

Java

PHP

Ruby

twilio-cli

curl


_19// Download the helper library from https://www.twilio.com/docs/node/install
_19const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_19
_19// Find your Account SID and Auth Token at twilio.com/console
_19// and set the environment variables. See http://twil.io/secure
_19const accountSid = process.env.TWILIO_ACCOUNT_SID;
_19const authToken = process.env.TWILIO_AUTH_TOKEN;
_19const client = twilio(accountSid, authToken);
_19
_19async function updateAccountSettings() {
_19  const setting = await client.insights.v1.settings().update({
_19    subaccountSid: "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
_19    voiceTrace: true,
_19  });
_19
_19  console.log(setting.accountSid);
_19}
_19
_19updateAccountSettings();

Output


_10{
_10  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "voice_trace": true,
_10  "advanced_features": true,
_10  "url": "https://insights.twilio.com/v1/Voice/Settings"
_10}