On this page
Operator manual

app:artist:delete

Delete an artist, its song and album credits, and its cover image. The command does what DELETE /api/artists/{publicId} does in the admin API, through the same use case.

Quick start

make exec cmd="php bin/console app:artist:delete V1StGXR8_Z5jdHi6B-myT"

Without a terminal, for example in a script:

make exec cmd="php bin/console app:artist:delete V1StGXR8_Z5jdHi6B-myT --force"

Arguments

Argument Required Description
public-id Yes The artist's public ID, as the API and the web app show it

Options

Option Description
--force Delete without asking; required when no terminal is attached
--json Print the API response's data payload: the counts of deleted artists and cover images

Details

On a terminal the command asks before it deletes anything. Without a terminal and without --force it deletes nothing and exits with code 2. --json does not stand in for --force.

The artist and its credits are deleted; the songs and albums stay. After that, the cover image record, its file and its derived files are deleted. This cannot be undone.

Exit codes

Code Meaning
0 Artist deleted
1 No artist has the public ID, the operator declined, or another error occurred; the message says why
2 The public ID is malformed, or no terminal is attached and --force was not given; nothing was deleted