Skip to content

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.

Path parameters and request body field map
FieldLocationTypeRequiredConstraints / Notes
accountIdPathstringRequiredIdentifier of the connected YouTube channel.
videoIdPathstringRequiredYouTube video ID. Length: 1 <= length.
titleRequest bodystringOptionalLength: 1 <= length <= 100.
descriptionRequest bodystringOptionalLength: length <= 5000.
tagsRequest bodyarray<string>OptionalArray of strings.
categoryIdRequest bodystringOptionalLength: 1 <= length.
privacyStatusRequest bodystringOptionalValue in "public" | "private" | "unlisted".
thumbnailUrlRequest bodystringOptionalFormat: uri.
madeForKidsRequest bodybooleanOptionalBoolean flag.
containsSyntheticMediaRequest bodybooleanOptionalBoolean flag.
playlistIdRequest bodystringOptionalLength: 1 <= length.

Exact source contract; origin modularized as {{API_BASE_URL}}.

Response status matrix
StatusContent typeResponse fields
200application/jsonsuccess (boolean, required), message (string, required), videoId (string, required), updatedFields (array<string>, required), warnings (array<string>, optional)
400application/jsonsuccess (boolean, required), message (string, required)
403application/jsonsuccess (boolean, required), message (string, required)
404application/jsonsuccess (boolean, required), message (string, required)
502application/jsonsuccess (boolean, required), message (string, required)

Exact supplied shapes only; no error codes invented.

PATCH request to update a YouTube video
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"
  }'
200 response body
{
  "success": true,
  "message": "string",
  "videoId": "string",
  "updatedFields": [
    "string"
  ],
  "warnings": [
    "string"
  ]
}
400, 403, 404 and 502 response body
{
  "success": true,
  "message": "string"
}
Interface fields
ScopeFieldTypeType referenceRequiredDescriptionConstraints
accountId#1accountIdstring__0Yesthe service integration ID of the connected YouTube channel.
videoId#2videoIdstring__0YesYouTube video ID.kind: schemaLength; value: 1 <= length
body#3bodyobject__0Yes
body#3body.titlestring__1Nokind: ; value: 1 <= length <= 100
body#3body.descriptionstring__2Nokind: ; value: length <= 5000
body#3body.tagsarray<string>__3No
body#3body.tags[]string__4
body#3body.categoryIdstring__5Nokind: ; value: 1 <= length
body#3body.privacyStatusstring__6Nokind: ; value: "public" | "private" | "unlisted"
body#3body.thumbnailUrlstring__7Nokind: ; value: uri
body#3body.madeForKidsboolean__8No
body#3body.containsSyntheticMediaboolean__9No
body#3body.playlistIdstring__10Nokind: ; value: 1 <= length
response#4responseobject__0
response#4response.successboolean__1Yes
response#4response.messagestring__2Yes
response#4response.videoIdstring__3Yes
response#4response.updatedFieldsarray<string>__4Yes
response#4response.updatedFields[]string__5
response#4response.warningsarray<string>__6No
response#4response.warnings[]string__7
response#5responseobject__0
response#5response.successboolean__1Yes
response#5response.messagestring__2Yes