---
title: "Update a metadata value"
method: PATCH
path: "/api/v0/video-narrative-metadata/metadata/{metadata_id}"
tags: ["video-narative-metadata > videoNarrativeMetadata"]
---

# Update a metadata value

`PATCH /api/v0/video-narrative-metadata/metadata/{metadata_id}`

Update a metadata value.

- Genre: The overall story category or narrative style of the content.
- Mood: The emotional tone or feeling the content creates.
- Subject: The main topic or theme the content focuses on.
- Format: The structural style or production type of the content.

## Path parameters

- `metadata_id` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- VideoNarativeMetadataUpdateMetadataRequest — Update fields of a metadata value.
  - `name` string, nullable
  - `description` string, nullable
  - `examples` string[], nullable

## Response `200`

Successful Response

- VideoNarativeMetadataUpdateMetadataResponse — Response for updated metadata.
  - `item` VideoNarativeMetadataMetadataItem, required — A metadata value.
    - `id` string, uuid, required
    - `metadata_type` 'genre' | 'mood' | 'subject' | 'format', required — Supported metadata types.
    - `name` string, required
    - `description` string, required
    - `examples` string[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-12** `3683abf6922b` — 1 info
  - api operation id `update-metadata-api-v-0-video-narrative-metadata-metadata-metadata-id-patch` removed and replaced with `videoNarativeMetadata_videoNarrativeMetadata_update_metadata_api_v0_video_narrative_metadata_metadata__metadata_id__patch`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v0/video-narrative-metadata/metadata/:metadata_id/patch.md)

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/coactive/apis/api-reference/revisions/3683abf6922b?raw)