Update YouTube video
Tool ID: youtube_video_update
Summary
Changes metadata on a video that is already uploaded. Nothing is written until you confirm.
When to use it
- Fix a title or description — Rewrite text without uploading the file again.
- Change privacy — Set a video to public, unlisted, or private when you say so explicitly.
- Tags, category, language, embed, or made-for-kids — Update those fields on an existing video.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| YouTube credentials | Yes |
| Your confirmation | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
video_id |
Yes | YouTube video id. |
confirm |
Yes | Must be true. The assistant should ask you before sending this. |
title |
No | New title. Cannot be blank. |
description |
No | New description. An empty description clears it. |
tags |
No | Replacement tag list. An empty list clears tags. |
category_id |
No | YouTube category id. |
default_language |
No | Language tag, such as en. |
privacy_status |
No | public, unlisted, or private. Leave it out to keep the current privacy. |
publish_at |
No | When the private video should go public, as a future time such as 2026-11-01T15:00:00Z. An empty value clears the schedule. The video must already be private, or this update must also set privacy to private. |
embeddable |
No | Whether other sites can embed the video. |
license |
No | youtube or creativeCommon. |
made_for_kids |
No | Self-declared made-for-kids setting. |
Fields you do not mention stay as they are.
What you get back
The video after the update, including privacy_status and publish_at (empty when the video is not scheduled).
Example prompts
Update the description of video id abcdefghijk to mention the new product name. Show me the new text and wait for me to confirm.
Set this video to unlisted. Do not change the title. Ask me to confirm first.
Add the tags launch and demo to this video, keep the existing description, and confirm with me before saving.
Schedule this video to publish on 1 November 2026 at 15:00 UTC. Make it private if it is not already, and ask me to confirm first.
Tips
- This does not trim, replace, or delete the video file.
- Privacy changes only when you ask for a new privacy status. Read the result and check
privacy_status. - A schedule only works on a private video. YouTube publishes it at
publish_at. Clearing that field removes the schedule. - Read the video first with Get video so the edit starts from the current text.