youtube_update_metadata
Destructive
Update approved metadata for an owned YouTube video, including title, description, tags, privacy, category, language, and future publish time.
Instructions
Write approved merged owned-video metadata. Public, scheduled, and synthetic-media changes need elevated intent. publishAt only works on a private video that has never been public, with a future ISO 8601 time.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"videoId": "<videoId>",
"approvalId": "<approvalId>"
},
"name": "youtube_update_metadata"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Replacement tag list, up to 500 tags of up to 500 characters each. | |
| title | No | New video title, up to 100 characters. | |
| confirm | No | Must be true to execute; set it only after youtube_approve approved this exact preview. | |
| publish | No | Must be true when privacyStatus is public, as a separate confirmation. | |
| videoId | Yes | ID of an owned video to update. | |
| elevated | No | Must be true for public, scheduled, synthetic-media or made-for-kids changes, after the user reviewed them. | |
| publishAt | No | Future ISO 8601 time. YouTube only schedules a private video that has never been public. | |
| approvalId | Yes | Approval ID from the youtube_preflight_update_metadata preview, after approving it with youtube_approve. | |
| categoryId | No | Numeric video category ID from youtube_list_video_categories. | |
| description | No | New video description, up to 5000 characters. | |
| privacyStatus | No | Visibility: private, unlisted or public. | |
| defaultLanguage | No | Default language code of the video, e.g. en. | |
| containsSyntheticMedia | No | Whether the video contains realistic altered or synthetic media; needs elevated: true. | |
| selfDeclaredMadeForKids | No | Whether the video is made for kids; needs elevated: true. |