> This page is for version v1.3 (default).
> For other versions, use one of these documentation indexes:
> - v1.3 (default): https://docs.twelvelabs.io/v1.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.twelvelabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.twelvelabs.io/_mcp/server.

## New features

Version 1.2 of the TwelveLabs Video Understanding Platform introduces the following new features:

* The alpha version of the Pegasus video understanding engine has been released. You can now use it to [analyze videos](/docs/guides/analyze-videos-and-images).
* You can now upload videos from external providers. Currently, only YouTube is supported as an external provider, but we will add support for additional providers in the future.

## Updates

This section lists the differences between version 1.1.2 and version 1.2 of the TwelveLabs Video Understanding API.

* When you make an API call, make sure that you specify the `1.2` version in the URL.
  The URL should look similar to the following one: `https://api.twelvelabs.io/v1.2/{resource}/{path_parameters}?{query_parameters}`. For more details, see the [Call an endpoint](/reference/api-reference#call-an-endpoint) section.
* To enable the utilization of multiple engines for an index, the following changes have been made:
  * **POST** `/indexes`: The `engine_id` and `indexing_options` parameters of the request have been deprecated. Instead, you can now define the engine configuration as a list of objects. See the [Create an index](/reference/create-index) page for details.
  * **GET** `/indexes/{index_id}`:  The `engine_id` field in the response has been superseded by an array of objects named `engines`. See the [Retrieve an index](/api-reference/indexes/retrieve) page for details.
  * **GET** `/indexes`:
    * The `engine_id` field in the response has been superseded by an array of objects named `engines`. See the [List indexes](/api-reference/indexes/list) page for details.
    * The `engine_family` query parameter has been introduced, allowing you to filter by engine family.
    * The `index_options` query parameter has been marked for deprecation. You can still use it in this version of the API, but it will be deprecated in a future release. Instead, use `engine_options` or `engine_family`.
  * **GET** `/engines`: The `allowed_index_option` field in the response has been renamed to `allowed_engine_options`.
  * **GET**`/engines/{engine-id}` The `allowed_index_option` field in the response has been renamed to `allowed_engine_options`. See the `Retrieve an engine page` for details.
* The `/search` and `/search/{page-token}` endpoints no longer return the `conversation_option`, `search_options`, and `query` fields.