Update YouTube Video API
The Update YouTube Video API updates YouTube video metadata, visibility, thumbnail, or playlist membership for an existing video without re-uploading it. Use it when the video already exists on a connected channel and only its presentation or settings need to change, rather than uploading a new file. The video must belong to the selected connected channel.
Update an existing YouTube video without re-uploading
This operation is for changing an existing video in place. It updates YouTube video metadata, visibility, thumbnail, or playlist membership without re-uploading the video, so it is the right choice when the media file is already published and only fields such as title, description, tags, category, privacy, thumbnail, audience flags, or playlist membership need to change. Use this update operation for in-place changes instead of uploading a new file. Before calling it, confirm that the target video belongs to the selected connected channel, because that ownership condition is required for the update.
Send the PATCH request
Send a PATCH request to the endpoint shown in the PATCH request example below, using the path parameters and request body described in the field map table. Include the x-access-key header with your token and set the Content-Type to application/json. Replace accountId with the identifier of the connected YouTube channel and videoId with the YouTube video ID you want to update. The example illustrates all nine optional request fields; in your own call, include the fields you intend to set using the exact field names and types in the table. The source contract marks every request-body field as optional, but it does not explicitly state that omitted fields are unchanged or that an empty body is valid, so do not rely on those behaviors beyond the stated optionality. Check the response for the updatedFields list to see which fields the response reports as updated.
Check the response and updatedFields
After a successful update, the 200 response returns success, message, videoId, and updatedFields, with warnings as an optional field. Treat updatedFields as the list reported by the response for that call, and inspect warnings when present. For 400, 403, 404, and 502 responses, the supplied body shape contains only success and message, so handle each status distinctly in your client and surface the message without inventing additional error codes. A practical failure check is to verify the returned videoId matches the video you targeted and that updatedFields contains the fields you sent; if it does not, do not report the update as complete.
| Field | Location | Type | Required | Constraints / Notes |
|---|---|---|---|---|
| accountId | Path | string | Required | Identifier of the connected YouTube channel. |
| videoId | Path | string | Required | YouTube video ID. Length: 1 <= length. |
| title | Request body | string | Optional | Length: 1 <= length <= 100. |
| description | Request body | string | Optional | Length: length <= 5000. |
| tags | Request body | array<string> | Optional | Array of strings. |
| categoryId | Request body | string | Optional | Length: 1 <= length. |
| privacyStatus | Request body | string | Optional | Value in "public" | "private" | "unlisted". |
| thumbnailUrl | Request body | string | Optional | Format: uri. |
| madeForKids | Request body | boolean | Optional | Boolean flag. |
| containsSyntheticMedia | Request body | boolean | Optional | Boolean flag. |
| playlistId | Request body | string | Optional | Length: 1 <= length. |
Exact source contract; origin modularized as {{API_BASE_URL}}.
| Status | Content type | Response fields |
|---|---|---|
| 200 | application/json | success (boolean, required), message (string, required), videoId (string, required), updatedFields (array<string>, required), warnings (array<string>, optional) |
| 400 | application/json | success (boolean, required), message (string, required) |
| 403 | application/json | success (boolean, required), message (string, required) |
| 404 | application/json | success (boolean, required), message (string, required) |
| 502 | application/json | success (boolean, required), message (string, required) |
Exact supplied shapes only; no error codes invented.
curl -X PATCH "{{API_BASE_URL}}/v1/youtube/accounts/{accountId}/videos/{videoId}" \
-H "Content-Type: application/json" \
-H "x-access-key: <token>" \
-d '{
"title": "Updated title",
"description": "Example post details.",
"tags": ["example", "update"],
"categoryId": "22",
"privacyStatus": "public",
"thumbnailUrl": "https://example.com/thumbnail.jpg",
"madeForKids": false,
"containsSyntheticMedia": false,
"playlistId": "PLexample"
}'{
"success": true,
"message": "string",
"videoId": "string",
"updatedFields": [
"string"
],
"warnings": [
"string"
]
}{
"success": true,
"message": "string"
}| Scope | Field | Type | Type reference | Required | Description | Constraints |
|---|---|---|---|---|---|---|
| accountId#1 | accountId | string | __0 | Yes | the service integration ID of the connected YouTube channel. | |
| videoId#2 | videoId | string | __0 | Yes | YouTube video ID. | kind: schemaLength; value: 1 <= length |
| body#3 | body | object | __0 | Yes | ||
| body#3 | body.title | string | __1 | No | kind: ; value: 1 <= length <= 100 | |
| body#3 | body.description | string | __2 | No | kind: ; value: length <= 5000 | |
| body#3 | body.tags | array<string> | __3 | No | ||
| body#3 | body.tags[] | string | __4 | |||
| body#3 | body.categoryId | string | __5 | No | kind: ; value: 1 <= length | |
| body#3 | body.privacyStatus | string | __6 | No | kind: ; value: "public" | "private" | "unlisted" | |
| body#3 | body.thumbnailUrl | string | __7 | No | kind: ; value: uri | |
| body#3 | body.madeForKids | boolean | __8 | No | ||
| body#3 | body.containsSyntheticMedia | boolean | __9 | No | ||
| body#3 | body.playlistId | string | __10 | No | kind: ; value: 1 <= length | |
| response#4 | response | object | __0 | |||
| response#4 | response.success | boolean | __1 | Yes | ||
| response#4 | response.message | string | __2 | Yes | ||
| response#4 | response.videoId | string | __3 | Yes | ||
| response#4 | response.updatedFields | array<string> | __4 | Yes | ||
| response#4 | response.updatedFields[] | string | __5 | |||
| response#4 | response.warnings | array<string> | __6 | No | ||
| response#4 | response.warnings[] | string | __7 | |||
| response#5 | response | object | __0 | |||
| response#5 | response.success | boolean | __1 | Yes | ||
| response#5 | response.message | string | __2 | Yes |