Retrieve a list of Operator Versions

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

GET/v3/ControlPlane/Operators/{id}/Versions

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

Retrieve a paginated list of all versions for a given Language Operator.

Request

Authentication

Basic Auth

Path parameters

Property nameTypeRequiredPIIDescription

idstring

requiredread-only

Not PII

The unique identifier (TTID) of the Language Operator.

Example: intelligence_operator_01k6fc25s7epm9qtk8rszbv3q5Pattern: ^intelligence_operator_[0-7][0-9a-z]{25}$

Query string

Property nameTypeRequiredPIIDescription

pageSizeinteger

Optional

Not PII

The maximum number of resources to return

Default: 50Minimum: 1Maximum: 1000

pageTokenstring

Optional

Not PII

Token for pagination

Responses

200404429500

A paginated list of Operator versions.

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

itemsarray[object]

Optional

Not PII

List of Operator versions.

Show items properties

metaobject

Optional

Not PII

Show meta 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

Too Many requests (rate limit exceeded for request originating from public API)

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

Retrieve a list of Operator Versions

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 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
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function listOperatorVersions() {
14  const versions = await client.intelligence.v3
15    .versions("intelligence_operator_01k6fc25s7epm9qtk8rszbv3q5")
16    .list({ limit: 20 });
17
18  versions.forEach((v) => console.log(v.version));
19}
20
21listOperatorVersions();

Response

1{
2  "items": [
3    {
4      "version": 5,
5      "status": "PREVIEW",
6      "dateCreated": "2026-02-10T14:00:00Z"
7    },
8    {
9      "version": 4,
10      "status": "ACTIVE",
11      "dateCreated": "2026-01-15T10:45:30Z"
12    },
13    {
14      "version": 3,
15      "status": "DEPRECATED",
16      "dateDeprecated": "2026-01-10T00:00:00Z",
17      "retirementDate": "2026-04-10T00:00:00Z",
18      "dateCreated": "2025-11-01T08:00:00Z"
19    },
20    {
21      "version": 2,
22      "status": "RETIRED",
23      "dateDeprecated": "2025-09-01T00:00:00Z",
24      "dateRetired": "2025-12-01T00:00:00Z",
25      "dateCreated": "2025-06-15T12:00:00Z"
26    }
27  ],
28  "meta": {
29    "key": "items",
30    "pageSize": 4
31  }
32}