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
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.
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.