Release Claim

/api/contentid/releaseClaim

The releaseClaim end point allows you to release content ID claims.

The Claim Release request

Claims can be released by track ID, video ID, claim ID, and channel ID. To release a claim or set of claims the request must include an array called release that contains the type of release to perform and the ID that corresponds to the specified release type. See the release type table below for detail on each release type.

claim release types
Type Description
claim releases a claim by it’s claim_id.
channel releases all claims for a channel by the channel’s YouTube channel_id.
track releases all claims for a track by the SourceAudio track_id.
video releases all claims for a video by the video’s YouTube video_id.

Example request

{
"release": [
{
"type": "claim",
"id": "x3iQ24dA5Rg"
},{
"type": "video",
"id": "795_F3qsdnY"
},{
"type": "track",
"id": 7640946
},{
"type": "channel",
"id": "UC_B7kPmEgq9QbgkwNKjG1Cg"
}
]
}
claim release request parameters
Parameter Required Type Description
release yes array Any array containing the parameters by which to release a claim or claims.
release.type yes string The type of id provided (claim, video, channel, or track)
release.id yes [stringint ] the id by which claim(s) should be released.

Example response

[
{
"id": "q0FBiSyqOGo",
"type": "claim",
"success": 1,
"result": [] //a result where no unreleased claims were found.
},{
"id": "WIReKnN3ez8",
"type": "video",
"success": 1,
"claim_total": 1,
"result": [
{
"claim_id": "s5F63MCwxY0",
"success": 1
}
]
},{
"id": "UC_B7kPmEgq9QbgkwNKjG1Cg",
"type": "channel",
"success": 1,
"claim_total": 3,
"result": [
{
"claim_id": "s5F63MCwxY0",
"success": 1
},{
"claim_id": "H6lqxXmKCyE",
"error": {
"error_code": 404,
"reason": "YouTube_API",
"error": "There was an error releasing this claim. The most common error is that the video has since been deleted or the music replaced."
}
},{
"claim_id": "2Rp4MH4PH5o",
"success": 1
}
]
}
]
The release response array.
Name Type Included Description
id mixed yes The ID provided in the release request
type string yes The type of ID specified for the release request
success int [01 ] 1 for success, 0 for unsuccessful
claim_total int The total number of claims released for the specified release parameter
error array An array included if an error occurred when attempting to process the release.
error.code int Error code
error.reason string Brief title to describe the release error.
error.msg string Further detail about release request failed.
result array An array containing claim release details of each claim found for the requested release parameters.
result.claim_id string yes The ID of the released claim.
result.success int [01 ] 1 for success, 0 for unsuccessful
result.error array An array included if an error occurred when attempting to release the claim.
result.error.code int Error code
result.error.reason string Brief title to describe the release error.
result.error.msg string Further detail about why the claim wasn’t released.