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

## User-defined metadata on asset upload

You can now attach user-defined metadata to your assets during upload. Previously, you could only add metadata after indexing a video. With this update, the following methods accept the `user_metadata` parameter:

* [Create an asset](/v1.3/api-reference/upload-content/direct-uploads/create)
* [Create a multipart upload session](/v1.3/api-reference/upload-content/multipart-uploads/create)
* [Index an asset](/v1.3/api-reference/index-content/create)

This release also introduces two new methods for managing user-defined metadata on existing assets:

* [Update the user-defined metadata of an asset](/v1.3/api-reference/upload-content/direct-uploads/update-user-metadata)
* [Delete the user-defined metadata of an asset](/v1.3/api-reference/upload-content/direct-uploads/delete-user-metadata)

**Update**: SDK support is now available.

## Timestamp formatting for analysis responses

You can now choose the output format for timestamps in both general analysis (prompt-based text generation) and video segmentation. This feature requires Pegasus 1.5.

**Update**: SDK support is now available.

### Timestamp formatting in structured responses

Declare a field as `{"type": "timestamp", "format": "<format>"}` to control the format of the returned value. Available formats: `seconds`, `hh:mm:ss`, and `hh:mm:ss.fff`.

For complete parameter specifications, see the following parameters in the API Reference section:

* **Sync analysis**: [`json_schema`](/v1.3/api-reference/analyze-videos/sync-analysis#request.body.response_format.json_schema).
* **Async analysis**: [`json_schema`](/v1.3/api-reference/analyze-videos/create-async-analysis-task#request.body.response_format.json_schema) and [`fields`](/v1.3/api-reference/analyze-videos/create-async-analysis-task#request.body.response_format.segment_definitions.fields).

### Format control for segment boundaries

Set the `segment_time_format` parameter to control the output format for the automatic `start_time` and `end_time` boundaries on each returned segment. Available formats: `seconds`, `hh:mm:ss`, and `hh:mm:ss.fff`.

For complete parameter specifications, see the [`segment_time_format`](/v1.3/api-reference/analyze-videos/create-async-analysis-task#request.body.response_format.segment_time_format) property in the API Reference section.