Method: references.updateStay organized with collectionsSave and categorize content based on your preferences.
Page Summary
This endpoint updates an existing YouTube reference using a PUT HTTP request to a specific URL with the reference ID included as a path parameter.
The request requires thereferenceIdpath parameter to specify the YouTube reference to be updated, along with optional query parameters likeonBehalfOfContentOwnerandreleaseClaims.
The request body should contain an instance of theReferenceresource, and a successful response will also contain an instance of the sameReferenceresource.
Updating a reference requires authorization with thehttps://www.googleapis.com/auth/youtubepartnerOAuth scope.
The releaseClaims query parameter allows for releasing all match claims associated with a reference, but only if the claim's status is being set to inactive.
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."],[],["The document outlines the process to update a YouTube reference via a PUT HTTP request to `https://youtubepartner.googleapis.com/youtube/partner/v1/references/{referenceId}`. It uses a required `referenceId` path parameter and optional `onBehalfOfContentOwner` and `releaseClaims` query parameters. The request and response bodies both utilize the `Reference` object. Successful updates require the `https://www.googleapis.com/auth/youtubepartner` OAuth scope. The `releaseClaims` parameter is only operational when setting a claim to inactive.\n"]]
