/product/
/product/{id} endpoint allows updating the details of a specific product identified by its unique ID.
Method:
PUT
Path Parameter:
| Parameter | Type | Description |
|---|---|---|
| id | string | The unique identifier of the product. |
| Parameter | Type | Description |
|---|---|---|
| catalogNumber | string | The updated catalog number of the product. |
| title | string | The updated title of the product. |
| displayArtist | string | The updated display artist. |
| type | string | The updated product type. |
| format | string | The updated format. |
| version | string | The updated version. |
| releaseDate | string | The updated release date. |
| takedownDate | string | The updated takedown date. |
| status | string | The updated status. |
| distribution | string | The updated distribution. |
| label | string | The updated label. |
| externalId | string | The updated external ID. |
| explicit | boolean | Whether the content is explicit. |
| mainGenre | array | Updated main genres. |
| subGenre | array | Updated sub genres. |
| contributors | array | Contributors information |
| metadata | object | Updated metadata. |
| artists | array | Updated artists. |
| assets | array | Updated assets. |
| media | array | Updated media. |
| upc | string | The updated UPC. |
| split | array | Updated split information. |
| file | string | for uploading media file |
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Product ID
Product title
1 - 255"Summer Vibes"
Custom product identifier
100"PROD-001"
Universal Product Code (auto-generated if not provided)
"123456789012"
Catalog number for the product
100"CAT-2024-001"
DEPRECATED Use catalogNumber instead
100External system identifier
100"EXT-12345"
Display name for the artist(s)
255"John Doe feat. Jane Smith"
Product type
Audio, Video, Ringtone "Audio"
Product version or variant
100"Deluxe Edition"
Whether the product contains explicit content
explicit, clean "clean"
Product release date
"2024-06-15"
Date when product should be taken down
"2024-12-31"
Primary genre
100"Pop"
Secondary genre
100"Dance Pop"
Product status
Live, Taken Down, Scheduled, Pending, Error Distribution settings and preferences
List of contributors and their roles
Additional product metadata
Historical chart positions for the product
[
{
"chart": "Billboard Hot 100",
"position": 10,
"date": "2024-01-15"
}
]Total number of tracks on the product
x >= 112
Total number of discs in the product
x >= 11
Physical/digital package type
"Digital Album"
Edition designation (e.g., Deluxe, Remastered, Anniversary)
"Deluxe Edition"
Whether this product is a reissue of a previous release
false
Original release date (for reissues)
"2020-06-15"
Recording studio/location
255"Abbey Road Studios, London"
Mastering studio/location
255"Sterling Sound, New York"
Producer name(s)
["Max Martin", "Shellback"]Engineer name(s)
["John Smith", "Jane Doe"]Sequence number in a series or discography
5
Parent release ID for variants or deluxe editions
"550e8400-e29b-41d4-a716-446655440000"
Primary language code (ISO 639-1)
10"en"
Copyright line year (©)
1900 <= x <= 21002024
Phonogram line year (℗)
1900 <= x <= 21002024
Associated artists with their roles
Artist ID (defaults to primary)
[
{ "id": "artist-123", "type": "primary" },
{ "id": "artist-456", "type": "featuring" }
]Associated media assets (tracks, videos)
[
{ "asset": "asset-789", "number": 1 },
{ "asset": "asset-790", "number": 2 }
]Uploaded file