Method: references.patchStay organized with collectionsSave and categorize content based on your preferences.
Page Summary
This endpoint allows you to update an existing YouTube reference using a PATCH request to the specified URL, with the reference ID provided as a path parameter.
TheonBehalfOfContentOwnerquery parameter lets users manage content on behalf of multiple content owners, andreleaseClaimsquery parameter allows for the release of claims associated with the reference being updated.
The request and response bodies both contain an instance of theReferenceresource, and can be found in theReferencedefinition.
Updating a reference requires authorization with thehttps://www.googleapis.com/auth/youtubepartnerOAuth scope.
ThereferenceIdparameter specifies the YouTube reference ID of the reference being updated.
Query parameters
Parameters
onBehalfOfContentOwner
string
TheonBehalfOfContentOwnerparameter identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.
releaseClaims
boolean
ThereleaseClaimsparameter indicates that you want to release all match claims associated with this reference. This parameter only works when the claim's status is being updated to 'inactive' - you can then set the parameter's value totrueto release all match claims produced by this reference.
Request body
The request body contains an instance ofReference.
Response body
If successful, the response body contains an instance ofReference.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],["This document details how to patch a YouTube reference using a PATCH HTTP request to the specified URL, including the reference ID as a path parameter. Optional query parameters allow acting on behalf of a content owner or releasing match claims. The request and response bodies both utilize the `Reference` resource. The process requires OAuth authorization with the `https://www.googleapis.com/auth/youtubepartner` scope. A try it section is available.\n"]]
