Content ID

Generate a single-use Content ID clearance code

Issues a one-time-use clearance code covering the whole Melodie library for a single YouTube video. The code is valid for 7 days from issuance and is consumed by the first video that uses it. Have the end user paste the code into the YouTube video description before publishing. Optionally attach a label — a note for your own reference, stored in Melodie only and never sent to the licensing provider.

post/api/v1/content_id/codes

Request

Headers

Authorizationstring required

Your API token.

Request body

labelstring

Optional note for your own reference (e.g. which video the code is for). Stored and shown in Melodie only — never sent to the licensing provider.

Example request

{
  "label": "Spring campaign teaser"
}

Response

Clearance code issued

Example response

{
  "data": {
    "id": "VC4R8T2NPL",
    "type": "content_id_code",
    "attributes": {
      "code": "VC4R8T2NPL",
      "start_date": "2026-10-29",
      "expiration_date": "2027-10-28",
      "label": "Summer campaign video",
      "video_id": "aBcD3fGh1jK"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.