Models an artist in Labelcamp. If several artists have the same name, the one with the highest priority will be selected by default by the application when an album is set to "active" status.
Managing Artists
Artist Association Mechanism
When a product becomes "active", Labelcamp automatically:
- Searches for an artist resource for each artist/contributor name
- Chooses the artist with the highest priority
- Creates a new artist with priority "1" if no existing match is found
- Associates the artist as a role with the product and track
Key Features
- Multiple DSP IDs: Artists can have multiple Digital Service Provider IDs through "availabilities"
- Duplicate Names: Supports multiple artists with the same name
- Proactive Creation: Allows creating artists in advance to control future release associations
Best Practices
- Set Default Artist: Assign the highest priority to the "default" artist to ensure correct future associations
- Create in Advance: Create artist resources before creating albums for better control
- Update Associations: To update artist associations on an existing product:
- Set the album status to "draft"
- Set it back to "active" to reprocess artist roles
Proactively managing artist resources ensures accurate metadata and DSP integrations across all releases.
List artists
Retrieve a paginated list of artists
query Parameters
page[number]Page number for pagination
page[size]Number of items per page (max 200)
filter[distributor-id]Filter by distributor ID
filter[name]Filter artists with a given name
filter[product-id]Filter artists associated with a specific product ID
Responses
Successful response
Array of resource objects (override with specific resource schema)
Related resources included in the response
Get artist details
Retrieve a single artist by ID
path Parameters
idResource ID
query Parameters
includeComma-separated list of related resources to include
Responses
Successful response
The primary resource object (override with specific resource schema)
Related resources included in the response