Update an Intelligence Configuration

(information)

Legal information

Conversation Intelligence, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum. For more details on AI usage and data, see AI Nutrition Facts for Conversation Intelligence.

Conversation Intelligence is not PCI compliant or a HIPAA Eligible Service and should not be used in workflows that are subject to HIPAA or PCI.

Conversations products are only available in the new Twilio Console. If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

PUT/v3/ControlPlane/Configurations/{id}

Base url: https://intelligence.twilio.com (Twilio Intelligence API)

Update an Intelligence Configuration, including its metadata and rules. The request must include all required fields.

Request

Authentication

Basic Auth

Path parameters

Property nameTypeRequiredPIIDescription

idstring

required

Not PII

The unique identifier of the Intelligence Configuration.

Example: intelligence_configuration_01k6fc25s7epm9qtk8rszbv3q5Pattern: ^intelligence_configuration_[0-7][0-9a-z]{25}$

Request body

Encoding type:application/json

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

displayNamestring

required

Not PII

The display name of the Intelligence Configuration describing its purpose.

Min length: 1Max length: 128

descriptionstring

Optional

Not PII

The description of the Intelligence Configuration further explaining its purpose.

rulesarray[object]

required

Not PII

List of Intelligence Configuration Rules that govern when and how Language Operators run. Each Rule represents a bundle of Operators, Triggers, Context, and Actions to be executed by the Intelligence Configuration on a Conversation. A maximum of five (5) Rules are allowed per Intelligence Configuration.

Max items: 5

Show rules properties

Property nameTypeRequiredPIIDescriptionChild properties

idstring

Optional

Not PII

Optional field used when updating an existing Rule within an Intelligence Configuration. When provided, the Rule with this id is updated; when omitted, a new Rule is created.

operatorsarray[object]

required

Not PII

List of Operators to be executed by the Rule. Minimum of one (1) and maximum of five (5) Operators allowed per Rule.

Min items: 1Max items: 5

Show operators properties

triggersarray[object]

Optional

Not PII

List of Triggers that determine when to activate the Rule. Maximum of one (1) Trigger allowed per Rule.

Max items: 1

Show triggers properties

actionsarray[object]

required

Not PII

List of Actions to be performed after the Rule is triggered. Maximum of two (2) Actions allowed per Rule.

Max items: 2

Show actions properties

contextobject

Optional

Not PII

Controls what additional customer and enterprise context is made available to Language Operators when this Rule executes.

Show context properties

Responses

200400404500

Intelligence configuration resource updated.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

accountIdstring

Optional

Not PII

The ID of the Account that created the Intelligence Configuration.

Example: ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

idstring

Optional

Not PII

The unique identifier for the Intelligence Configuration. Assigned by Twilio (TTID).

displayNamestring

Optional

Not PII

The display name of the Intelligence Configuration describing its purpose.

Min length: 1Max length: 128

descriptionstring

Optional

Not PII

The description of the Intelligence Configuration further explaining its purpose.

versioninteger

Optional

Not PII

The numeric version of the Intelligence Configuration. Automatically incremented with each update on the resource, used to ensure integrity when updating the Configuration.

rulesarray[object]

Optional

Not PII

Max items: 5

Show rules properties

Property nameTypeRequiredPIIDescriptionChild properties

idstring

Optional

Not PII

The unique identifier for the Rule. Assigned by Twilio (TTID).

operatorsarray[object]

Optional

Not PII

List of Operators to be executed by the Rule. Maximum of five (5) Operators allowed per Rule.

Max items: 5

Show operators properties

triggersarray[object]

Optional

Not PII

List of Triggers that determine when to activate the Rule. Maximum of one (1) Trigger allowed per Rule.

Max items: 1

Show triggers properties

actionsarray[object]

Optional

Not PII

List of Actions to be performed after the Rule is triggered. Maximum of two (2) Actions allowed per Rule.

Max items: 2

Show actions properties

contextobject

Optional

Not PII

Controls what additional customer and enterprise context is made available to Language Operators when this Rule executes.

Show context properties

dateCreatedstring<date-time>

Optional

Not PII

Timestamp of when the Intelligence Configuration was created.

dateUpdatedstring<date-time>

Optional

Not PII

Timestamp of when the Intelligence Configuration was last updated.

Bad request

Schema

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

Not PII

Twilio-specific error code

messagestring

Optional

Not PII

A human readable error message

httpStatusCodeinteger<int32>

Optional

Not PII

HTTP response status code

userErrorboolean

Optional

Not PII

Whether the error is a user error (true) or a system error (false)

paramsobject

Optional

Not PII

A map of parameters related to the error, for example, a params.twilioErrorCodeUrl might hold a URL or link to additional information

Show params properties

Resource not found

Schema

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

Not PII

Twilio-specific error code

messagestring

Optional

Not PII

A human readable error message

httpStatusCodeinteger<int32>

Optional

Not PII

HTTP response status code

userErrorboolean

Optional

Not PII

Whether the error is a user error (true) or a system error (false)

paramsobject

Optional

Not PII

A map of parameters related to the error, for example, a params.twilioErrorCodeUrl might hold a URL or link to additional information

Show params properties

Internal server error

Schema

Property nameTypeRequiredPIIDescriptionChild properties

codeinteger<int32>

Optional

Not PII

Twilio-specific error code

messagestring

Optional

Not PII

A human readable error message

httpStatusCodeinteger<int32>

Optional

Not PII

HTTP response status code

userErrorboolean

Optional

Not PII

Whether the error is a user error (true) or a system error (false)

paramsobject

Optional

Not PII

A map of parameters related to the error, for example, a params.twilioErrorCodeUrl might hold a URL or link to additional information

Show params properties

Update an Intelligence Configuration

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 updateConfiguration() {
11  const configuration = await client.intelligence.v3
12    .configurations("intelligence_configuration_01k6fc25s7epm9qtk8rszbv3q5")
13    .update({
14      displayName: "real-time-intelligence-config",
15      description:
16        "Intelligence configuration to trigger real-time script adherence operator",
17      rules: [
18        {
19          id: "intelligence_configurationrule_01kermhm81fwfvy7j0f7h7v5mr",
20          operators: [
21            {
22              id: "intelligence_operator_01kcgy1ew0e9x8re6jq542zt8b",
23              version: 4,
24              parameters: {
25                scale: 2,
26              },
27            },
28          ],
29          triggers: [
30            {
31              on: "COMMUNICATION",
32              parameters: {
33                count: 2,
34              },
35            },
36          ],
37          actions: [
38            {
39              type: "WEBHOOK",
40              method: "POST",
41              url: "https://my-webhook-endpoint.com/rule-action",
42            },
43          ],
44          context: {
45            memory: {
46              enabled: true,
47            },
48            knowledge: {
49              bases: ["knowledge_base_id"],
50            },
51          },
52        },
53      ],
54    });
55
56  console.log(configuration.accountId);
57}
58
59updateConfiguration();

Response

1{
2  "accountId": "AC00000000000000000000000000000000",
3  "id": "intelligence_configuration_01k6fc25s7epm9qtk8rszbv3q5",
4  "displayName": "real-time-intelligence-config",
5  "description": "Intelligence configuration to trigger real-time script adherence operator",
6  "version": 1,
7  "rules": [
8    {
9      "id": "intelligence_configurationrule_01kermhm81fwfvy7j0f7h7v5mr",
10      "operators": [
11        {
12          "id": "intelligence_operator_01kcgy1ew0e9x8re6jq542zt8b",
13          "version": 4,
14          "parameters": {
15            "scale": 2
16          }
17        }
18      ],
19      "triggers": [
20        {
21          "on": "COMMUNICATION",
22          "parameters": {
23            "count": 2
24          }
25        }
26      ],
27      "actions": [
28        {
29          "type": "WEBHOOK",
30          "method": "POST",
31          "url": "https://my-webhook-endpoint.com/rule-action"
32        }
33      ],
34      "context": {
35        "memory": {
36          "enabled": true
37        },
38        "knowledge": {
39          "bases": [
40            "knowledge_base_id"
41          ]
42        }
43      }
44    }
45  ],
46  "dateCreated": "2026-01-12T08:18:17Z",
47  "dateUpdated": "2026-01-12T08:18:17Z"
48}