Skip to contentSkip to navigationSkip to topbar
Twilio Docs

Retrieve 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(link takes you to an external page). 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(link takes you to an external page). If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

GET/v3/ControlPlane/Configurations/{id}

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

Request

fetch-configuration-request page anchor

Authentication

authentication page anchor

Path parameters

fetch-configuration-path-parameters page anchor
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}$

Responses

fetch-configuration-responses page anchor
200404500

A single Intelligence Configuration resource.

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

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
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.

Retrieve an Intelligence ConfigurationLink to code sample: Retrieve an Intelligence Configuration
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 and Auth Token at twilio.com/console

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

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function fetchConfiguration() {

11
  const configuration = await client.intelligence.v3

12
    .configurations("intelligence_configuration_01k6fc25s7epm9qtk8rszbv3q5")

13
    .fetch();

14


15
  console.log(configuration.accountId);

16
}

17


18
fetchConfiguration();

Response

Note about this 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": 3

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
}