Skip to main content

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​

NameTypeDescription
discogsIdLongDiscogs release ID. If provided, the release data will be imported from Discogs when creating the item.
creatorsIdStringCreators ID. If provided, the release data will be imported from Creators when creating the item.
contributeToCreatorsBooleanitemCreate 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.
titleStringTitle of the release.
identifiers[ItemIdentifierInput]List of identifiers such as barcodes or catalog numbers.
countryStringCountry 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.
releaseDateDateRelease date of the music release.
weightFloatWeight 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 ⚠️IntRelease year. This field is deprecated; use releaseDate instead. ⚠️ Deprecated: No longer supported
assetLinkStringLink to an external asset or resource related to the release.
hsCodeStringCustoms 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.