API write capabilities extended

This release extends the API's write capabilities.

You can now create, update and delete Artists, Record Labels, Catalogs, Tag Categories and Tags directly through the API, and the Artist and Record Label payloads now return significantly more data.

New endpoints

Artists (Write operations added)

New endpoint added: POST /api/artists
New endpoint added: PUT /api/artists/{uuid}
New endpoint added: DELETE /api/artists/{uuid}

Record Labels (Write operations added)

New endpoint added: POST /api/record_labels
New endpoint added: PUT /api/record_labels/{uuid}
New endpoint added: DELETE /api/record_labels/{uuid}

Catalogs (Write operations added)

New endpoint added: POST /api/catalogs
New endpoint added: PUT /api/catalogs/{uuid}
New endpoint added: DELETE /api/catalogs/{uuid}

Tag Categories (Write operations added)

New endpoint added: POST /api/tag_categories
New endpoint added: PUT /api/tag_categories/{uuid}
New endpoint added: DELETE /api/tag_categories/{uuid}

Tags (Write operations added)

New endpoint added: POST /api/tags
New endpoint added: PUT /api/tags/{uuid}
New endpoint added: DELETE /api/tags/{uuid}

Writable fields

Artist

Field	Type	Description
`name`	string	The name of the artist. Required on creation.
`legal_name`	string	The legal name of the artist.
`ipi`	string	The IPI number of the artist (11 digits).
`isni`	string	The ISNI of the artist.
`apple_identifier`	string	The Apple identifier of the artist.
`spotify_identifier`	string	The Spotify identifier of the artist.
`youtube_identifier`	string	The YouTube identifier of the artist.
`country_code`	string	The ISO code of the artist's country.
`notes`	string	Notes about the artist.
`tag_uuids`	array	The UUIDs of the tags of the artist.
`rightholder_uuids`	array	The UUIDs of the contacts and companies rights-holders associated to the artist.
`translated_names`	array	The translated names of the artist (each with `name` and optional `language_code`). Replaces the existing list on update.

Record Label

Field	Type	Description
`name`	string	The name of the record label. Required on creation.
`isni`	string	The ISNI of the record label.
`label_code`	string	The label code of the record label.
`notes`	string	Notes about the record label.
`tag_uuids`	array	The UUIDs of the tags of the record label.
`rightholder_uuids`	array	The UUIDs of the contacts and companies rights-holders associated to the record label.
`translated_names`	array	The translated names of the record label (each with `name` and optional `language_code`). Replaces the existing list on update.

Catalog

Field	Type	Description
`name`	string	The name of the catalog. Required on creation.

Tag Category

Field	Type	Description
`name`	string	The name of the tag category. Required on creation.

Tag

Field	Type	Description
`name`	string	The name of the tag. Required on creation.
`tag_category_uuid`	string	The UUID of the tag category this tag belongs to. Must reference a tag category of type `internal`. Required on creation.

New response fields

Artist

Field	Type	Description
`legal_name`	string	The legal name of the artist.
`ipi`	string	The IPI number of the artist.
`isni`	string	The ISNI of the artist.
`apple_identifier`	string	The Apple identifier of the artist.
`spotify_identifier`	string	The Spotify identifier of the artist.
`youtube_identifier`	string	The YouTube identifier of the artist.
`notes`	string	The notes of the artist.
`translated_names`	array	The translated names of the artist (each with `name` and `language`).
`rightholders`	array	The rights-holders (contacts and companies) associated to the artist (each with `uuid`, `type` and `name`).

Record Label

Field	Type	Description
`isni`	string	The ISNI of the record label.
`label_code`	string	The label code of the record label.
`notes`	string	The notes of the record label.
`translated_names`	array	The translated names of the record label (each with `name` and `language`).
`rightholders`	array	The rights-holders (contacts and companies) associated to the record label (each with `uuid`, `type` and `name`).

New error code

Code	HTTP Status	Description
`ERROR_READ_ONLY_RESOURCE`	403	The resource is read-only and cannot be updated.

Behaviour notes

Read-only tag categories and tags. Auto-generated tag categories (and their tags) cannot be modified through the API. PUT /api/tag_categories/{uuid} and PUT /api/tags/{uuid} return 403 with the ERROR_READ_ONLY_RESOURCE code in that case.
Asynchronous deletion for tags and tag categories. DELETE /api/tags/{uuid} and DELETE /api/tag_categories/{uuid} enqueue a background job and return 204 No Content immediately. The category or tag (and all of its taggings) is removed shortly after.