Skip to main content

Artist

The canonical work, not a binding to a provider. deadair.artists minus the columns that only ingest cares about: artist_key is a match key, and a row with merged_into_id set is never read out at all.

imageUrl on both contracts below is always a path under the API root, never a provider's URL: art/<uuid> for the station's cached copy, or art/source/<token> for one it has not cached yet, which the station fetches on first ask and serves as its own. Resolve either against the API base the client already configures (the API mounts at the root and does not know the /api prefix the edge adds). The switch from the second to the first happens server-side.

Attributes (8)
AttributeTypeRequiredDescription
idstringYesread-only
namestringYes
mbidstringNoMusicBrainz artist id, absent until enrichment resolves one
imageUrlstringNoAn API-relative path: the cached copy, or the station's proxy for an uncached one
ratingRatingYesdefault: neutral
suspendedUntilstringNoKept off the station until this moment: a scheduling decision with an end date, which leaves rating alone. Absent is not suspended, and a suspension that has lapsed is simply absent. read-only
albumCountnumberYesUnmerged albums credited to this artist. read-only
trackCountnumberYesUnmerged tracks credited to this artist. read-only