---
title: "Retrieve a list of Operator Versions"
method: GET
path: "/v3/ControlPlane/Operators/{id}/Versions"
tags: ["Operators"]
---

# Retrieve a list of Operator Versions

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

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

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

A paginated list of Operator versions.

- object — Paginated list of Operator versions.
  - `items` object[], required — List of Operator versions.
    - `version` integer, required — The numeric version number.
    - `status` 'PREVIEW' | 'ACTIVE' | 'DEPRECATED' | 'RETIRED', required — The lifecycle status of an Operator version. Available values: - `PREVIEW`: Available but restricted to internal/testing visibility. Normal execution. - `ACTIVE`: Available for normal use. - `DEPRECATED`: Still executes normally, but a Warn event is emitted via the Watch product lifecycle system. Customers should migrate to a newer version. - `RETIRED`: Hard failure on execution. An Error is logged in Watch. Customers must manually update their Intelligence Configuration to a valid version.
    - `dateCreated` string, date-time, required — Timestamp of when this version was created.
    - `dateDeprecated` string, date-time — Timestamp of when this version was deprecated. Present when status is `DEPRECATED` or `RETIRED`.
    - `retirementDate` string, date-time — Scheduled retirement date for this version. Present when status is `DEPRECATED`.
    - `dateRetired` string, date-time — Timestamp of when this version was retired. Present when status is `RETIRED`.
  - `meta` object, required
    - `key` string, required — A key, sibling to the `meta` object that holds the actual list of resources
    - `pageSize` integer, required — The actual number of resources returned in the response
    - `previousToken` string
    - `nextToken` string

## Other responses

- `404` — Resource not found
- `429` — Too Many requests (rate limit exceeded for request originating from public API)
- `500` — Internal server error

---

[API](https://skmtc.net/twilio/apis/twilio-intelligence.md) · [All operations](https://skmtc.net/twilio/apis/twilio-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-intelligence/revisions/3a830979326d/schema)