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

## Replace the user-defined metadata of an asset

You can now replace the entire user-defined metadata of an asset in a single call with the new [`PUT`](/v1.3/api-reference/upload-content/direct-uploads/replace-user-metadata) method of the `/assets/{asset_id}/user-metadata` endpoint. The method overwrites the stored value in its entirety and removes any keys you omit from the request body. Unlike the existing [`PATCH`](/v1.3/api-reference/upload-content/direct-uploads/update-user-metadata) method, this method does not merge your changes into the existing metadata. The method is available in the [Python SDK](/v1.3/sdk-reference/python/manage-assets#replace-the-user-defined-metadata-of-an-asset) and [Node.js SDK](/v1.3/sdk-reference/node-js/manage-assets#replace-the-user-defined-metadata-of-an-asset).
To access this feature, upgrade your SDK to the latest version:

**`Python SDK`**

```sh Python SDK
pip install --upgrade twelvelabs
```

**`Node.js SDK`**

```sh Node.js SDK
npm install twelvelabs-js@latest
```