API REFERENCE

Add Artist to Account

On this page

POST/api/accounts/artists

Add an artist to an account's list of associated artists. If the artist is already associated with the account, returns success without modification.

Authentication

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

Request

cURL

curl --request POST \
  --url 'https://api.recoupable.dev/api/accounts/artists' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "string",
  "artistId": "YOUR_ID"
}'

Request body required

Account and artist identifiers

application/json

emailstringrequired

Email address of the account to add the artist to

format: email

artistIdstringrequired

The unique identifier of the artist to add

format: uuid

Responses

200Artist added to account successfully

application/json

successboolean · enumrequired

Indicates the artist was successfully added

Values: true

400Bad request - account not found

application/json

statusstring · enumrequired

Status of the request

Values: "error"

messagestringrequired

Error message describing what went wrong

Full specification

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

Download accounts.json

View operation source

json

{
  "description": "Add an artist to an account's list of associated artists. If the artist is already associated with the account, returns success without modification.",
  "requestBody": {
    "description": "Account and artist identifiers",
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/AddArtistToAccountRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Artist added to account successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AddArtistSuccessResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request - account not found",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AccountErrorResponse"
          }
        }
      }
    }
  }
}