> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recoupable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Artist

> Delete an artist accessible to the authenticated account.



## OpenAPI

````yaml api-reference/openapi/releases.json DELETE /api/artists/{id}
openapi: 3.1.0
info:
  title: Recoup API - Releases
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/artists/{id}:
    delete:
      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'
components:
  schemas:
    DeleteArtistResponse:
      type: object
      required:
        - success
        - artistId
      properties:
        success:
          type: boolean
          description: Whether the artist delete completed successfully
        artistId:
          type: string
          format: uuid
          description: UUID of the artist account that was deleted or unlinked
    DeleteArtistErrorResponse:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        error:
          type: string
          description: Error message describing what went wrong

````