RecoupGet a free auditFree audit

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"
}'

Try it

Fill in the fields, send the request from your browser, and read the live response. The curl below updates as you type.

Kept in this browser tab only and cleared when it closes.

cURL for this request
curl --request POST \
  --url 'https://recoup-api.vercel.app/api/accounts/artists' \
  --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"
          }
        }
      }
    }
  }
}