---
title: "Partial update video information"
method: PATCH
path: "/indexes/{index-id}/videos/{video-id}"
tags: ["indexes > videos"]
---

# Partial update video information

`PATCH /indexes/{index-id}/videos/{video-id}`

## Request

- Base URL: `https://api.twelvelabs.io/v1.3`
- URL: `https://api.twelvelabs.io/v1.3/indexes/{index-id}/videos/{video-id}`
- Auth: API key in header `x-api-key`

<Info>This method will be deprecated in a future version. New implementations should use the [Partial update indexed asset](/v1.3/api-reference/index-content/update) method.</Info>

This method updates one or more fields of the metadata of a video. Also, can delete a field by setting it to `null`.

## Path parameters

- `index-id` string, required
- `video-id` string, required

## Request body

- object
  - `user_metadata` UserMetadata: Metadata that helps you categorize your assets. The object contains user-defined keys and values, where keys are strings. Each value is a string, a number, a boolean, or an array of strings. Send an integer wider than 53 bits (-9007199254740991 to 9007199254740991), and any identifier you want preserved verbatim, as a string. **Example**: ```JSON "user_metadata": { "category": "recentlyAdded", "batchNumber": 5, "rating": 9.3, "needsReview": true, "hashtags": ["summer", "vlog"] } ```

## Response `200`

Successful response

## Other responses

- `400`: The request has failed.

## Changes

- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `update` removed and replaced with `indexes_videos_update`
- **2026-09-10** `1ff50bf76720`: 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `user_metadata/additionalProperties/` request property `oneOf` list
- **2026-07-31** `5dbd6e8473c9`: 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662`: 1 breaking, 1 info
  - removed the success response with the status `204`
  - added the success response with the status `200`

[Operation history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/indexes/:index-id/videos/:video-id/patch.md)

---

[API](https://skmtc.dev/twelvelabs/apis/twelvelabs-api.md) - [All operations](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/revisions/c23c6e18fdd1?raw)