Skip to main content
PATCH
/
api
/
artists
/
{id}
cURL
curl --request PATCH \
  --url https://recoup-api.vercel.app/api/artists/{id} \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "The Weeknd",
  "image": "https://i.scdn.co/image/abc123",
  "instruction": "Always reference the artist's R&B catalog when discussing collaborations.",
  "label": "XO / Republic Records",
  "knowledges": [
    {
      "name": "Artist Knowledge Base Report",
      "url": "https://arweave.net/abc123",
      "type": "text/plain"
    }
  ],
  "profileUrls": {
    "SPOTIFY": "https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ",
    "INSTAGRAM": "https://instagram.com/theweeknd"
  },
  "pinned": true
}
EOF
{
  "artist": {
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "account_socials": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "username": "<string>",
        "profile_url": "<string>",
        "link": "<string>",
        "type": "<string>"
      }
    ],
    "pinned": true,
    "image": "<string>",
    "instruction": "<string>",
    "label": "<string>",
    "knowledges": [
      {
        "name": "Artist Knowledge Base Report",
        "url": "https://arweave.net/abc123",
        "type": "text/plain"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
id
string<uuid>
required

Artist account ID to update.

Body

application/json

Fields to update. At least one field must be provided.

All fields are optional. The request must include at least one field.

​
name
string

Artist display name

Example:

"The Weeknd"

​
image
string

Artist profile image URL. Pass an empty string to clear the existing image; otherwise must be a valid URL.

Example:

"https://i.scdn.co/image/abc123"

​
instruction
string

Custom AI instruction shown to assistants when this artist is the active context

Example:

"Always reference the artist's R&B catalog when discussing collaborations."

​
label
string

Record label name

Example:

"XO / Republic Records"

​
knowledges
object[]

Knowledge base entries for this artist. Replaces the existing array when provided.

​
profileUrls
object

Map of uppercase platform identifier to social profile URL. Each entry replaces the existing social for that platform; platforms not included are preserved. Recognized keys: SPOTIFY, INSTAGRAM, TIKTOK, TWITTER, YOUTUBE, APPLE, FACEBOOK, THREADS. Keys are matched case-sensitively — lowercase keys will create duplicate socials instead of replacing the existing entry.

Example:
{
  "SPOTIFY": "https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ",
  "INSTAGRAM": "https://instagram.com/theweeknd"
}
​
pinned
boolean

Pin or unpin the artist for the authenticated account. Affects only the caller's pin state, not other accounts.

Response

Artist updated successfully

​
artist
object
required