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

## Introducing asset management

This release introduces new asset management capabilities. It also includes the first set of changes for the [deletion safeguards](/docs/get-started/release-notes/2026/4/8) announced on April 8.

### HLS streaming and thumbnail generation

You can now request HLS playlists and thumbnail images when creating an asset. Set the `enable_hls` or `enable_thumbnail` field to `true` in your request to the [`POST`](/v1.3/api-reference/upload-content/direct-uploads/create) method of the `/assets` endpoint or the [`POST`](/v1.3/api-reference/upload-content/multipart-uploads/create) method of the `/assets/multipart-uploads` endpoint. The platform generates these in the background. To check progress, call the [`GET`](/v1.3/api-reference/upload-content/direct-uploads/retrieve) method of the `/assets/{asset_id}` endpoint and inspect the `hls.status` and `thumbnail.status` fields.

### New response fields

The following response schemas now include new fields:

* **Asset**: The `size` field contains the file size in bytes. The `duration` field contains the length in seconds for video and audio assets. The `method` field can now also return `multipart` for assets uploaded through the multipart upload flow.
* **Indexed asset**: The `asset_id` field identifies the source asset, so you can trace an indexed asset back to the asset it was created from.
* **Entity**: The `entity_collection_id` field identifies the collection the entity belongs to.

### Filename filtering

The [`GET`](/v1.3/api-reference/upload-content/direct-uploads/list) method of the `/assets` endpoint now accepts the `filename` query parameter to filter assets by filename. The match is case-insensitive and supports partial matches.

### Look up indexed assets and entities by asset

As [announced on April 8](/docs/get-started/release-notes/2026/4/8), the following are now available:

* The [`GET`](/v1.3/api-reference/index-content/list-indexed-assets-by-asset) method of the `/assets/{asset_id}/indexed-assets` endpoint lists the indexed assets that reference a given asset.
* The [`GET`](/v1.3/api-reference/entities/list-entities-by-asset) method of the `/assets/{asset_id}/entities` endpoint lists the entities that reference a given asset.
* The `force` query parameter on the [`DELETE`](/v1.3/api-reference/upload-content/direct-uploads/delete) method of the `/assets/{asset_id}` endpoint lets you delete the asset even if indexed assets reference it.

On **April 26, 2026**, delete requests for referenced assets will be denied by default. See the [April 8 announcement](/docs/get-started/release-notes/2026/4/8) for required actions.