API REFERENCE

Delete Artist

On this page

DELETE/api/artists/{id}

Delete an artist accessible to the authenticated account. This removes the caller's direct artist link and, if no owner links remain, deletes the artist account itself.

Authentication

See the authentication guide for API key and account access requirements.

Request

cURL

curl --request DELETE \
  --url 'https://api.recoupable.dev/api/artists/YOUR_ID' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "account_id": "YOUR_ID"
}'

Replace the YOUR_ placeholders with your values. Required query parameters are included; optional parameters are listed below.

Parameters

Path parameters

idstringrequired

Artist account ID to delete.

Request body

Optional account context override.

application/json

account_idstring

UUID of the account whose artist should be deleted. Only applicable when the authenticated account has access to multiple accounts via organization membership or Recoup admin access. If not provided, the deletion runs in the API key's own account context.

format: uuid

Responses

200Artist deleted successfully

application/json

successbooleanrequired

Whether the artist delete completed successfully

artistIdstringrequired

UUID of the artist account that was deleted or unlinked

format: uuid

400Bad request - account_id is not a valid UUID

application/json

statusstring · enumrequired

Status of the request

Values: "error"

errorstringrequired

Error message describing what went wrong

401Unauthorized - missing or invalid authentication

No response body schema is specified.

403Forbidden - the authenticated account cannot delete this artist

application/json

statusstring · enumrequired

Status of the request

Values: "error"

errorstringrequired

Error message describing what went wrong

404Artist not found

application/json

statusstring · enumrequired

Status of the request

Values: "error"

errorstringrequired

Error message describing what went wrong

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download releases.json

View operation source

json

{
  "description": "Delete an artist accessible to the authenticated account. This removes the caller's direct artist link and, if no owner links remain, deletes the artist account itself.",
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "description": "Artist account ID to delete.",
      "required": true,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    }
  ],
  "requestBody": {
    "description": "Optional account context override.",
    "required": false,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "account_id": {
              "type": "string",
              "format": "uuid",
              "description": "UUID of the account whose artist should be deleted. Only applicable when the authenticated account has access to multiple accounts via organization membership or Recoup admin access. If not provided, the deletion runs in the API key's own account context."
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Artist deleted successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request - account_id is not a valid UUID",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized - missing or invalid authentication"
    },
    "403": {
      "description": "Forbidden - the authenticated account cannot delete this artist",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "Artist not found",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistErrorResponse"
          }
        }
      }
    }
  }
}