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	[string ∣ int ]	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		[0 ∣ 1 ] 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		[0 ∣ 1 ] 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.