ItemReleaseInput Input
Description
Input fields for creating or updating a music release item, including release metadata, tracklist, formats, and associated artists and labels.
Declaration
input ItemReleaseInput {
discogsId: Long
creatorsId: String
contributeToCreators: Boolean
title: String
identifiers: [ItemIdentifierInput]
country: String
formats: [ItemReleaseFormatInput!]
tracklist: [ItemReleaseTrackInput!]
releaseDate: Date
weight: Float
genres: [String]
styles: [String]
images: [ItemImageInput]
artists: [ItemReleaseArtistInput]
year: Int
assetLink: String
hsCode: String
labels: [ItemReleaseLabelInput]
videos: [ItemReleaseVideoInput]
}
Fields
| Name | Type | Description |
|---|---|---|
discogsId | Long | Discogs release ID. If provided, the release data will be imported from Discogs when creating the item. |
creatorsId | String | Creators ID. If provided, the release data will be imported from Creators when creating the item. |
contributeToCreators | Boolean | itemCreate only, for a release given by its data (no discogsId or creatorsId). True adds the release to Creators, the catalogue every shop shares, and imports the item from it; without it the item is created in your shop only. Contributing requires every artist and label (the tracks' included) to carry its id or discogsId, as releaseEntitySearch returns them, or createInCreators: true: the item is refused otherwise, and when Creators refuses the data. When Creators already holds a release that is very likely the same record (the same catalogue number and title, with nothing that makes it another pressing), the item is created on that release and no new one is added: the returned item's creatorsId tells which. Images are not part of it: register them with itemImageRegister and contributeToCreators to add them to the Creators release. |
title | String | Title of the release. |
identifiers | [ItemIdentifierInput] | List of identifiers such as barcodes or catalog numbers. |
country | String | Country code where the release was issued (ISO 3166-1 alpha-2 format, e.g., "US", "GB", "FR"). |
formats | [ItemReleaseFormatInput!] | List of physical formats for the release (e.g., vinyl, CD, cassette). |
tracklist | [ItemReleaseTrackInput!] | List of tracks on the release, including title, position, duration, and associated artists. |
releaseDate | Date | Release date of the music release. |
weight | Float | Weight of the release in grams. |
genres | [String] | List of genre names associated with the release (e.g., "Electronic", "Rock", "Jazz"). |
styles | [String] | List of style names associated with the release (e.g., "House", "Techno", "Ambient"). |
images | [ItemImageInput] | List of images associated with the release, typically including cover art. |
artists | [ItemReleaseArtistInput] | List of main artists associated with the release. |
year ⚠️ | Int | Release year. This field is deprecated; use releaseDate instead. ⚠️ Deprecated: No longer supported |
assetLink | String | Link to an external asset or resource related to the release. |
hsCode | String | Customs HS code for international shipments. Null = platform default for the item type. |
labels | [ItemReleaseLabelInput] | List of record labels associated with the release. |
videos | [ItemReleaseVideoInput] | List of videos associated with the release. |