curl --request PATCH \
--url https://api.recoupable.dev/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",
"TIKTOK": "https://tiktok.com/@theweeknd",
"TWITTER": "https://x.com/theweeknd",
"YOUTUBE": "https://youtube.com/@theweeknd",
"APPLE": "https://music.apple.com/us/artist/the-weeknd/479756766",
"FACEBOOK": "https://facebook.com/theweeknd",
"THREADS": "https://threads.net/@theweeknd",
"BANDSINTOWN": "https://www.bandsintown.com/a/1371750-the-weeknd"
},
"pinned": true
}
EOFimport requests
url = "https://api.recoupable.dev/api/artists/{id}"
payload = {
"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",
"TIKTOK": "https://tiktok.com/@theweeknd",
"TWITTER": "https://x.com/theweeknd",
"YOUTUBE": "https://youtube.com/@theweeknd",
"APPLE": "https://music.apple.com/us/artist/the-weeknd/479756766",
"FACEBOOK": "https://facebook.com/theweeknd",
"THREADS": "https://threads.net/@theweeknd",
"BANDSINTOWN": "https://www.bandsintown.com/a/1371750-the-weeknd"
},
"pinned": True
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
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',
TIKTOK: 'https://tiktok.com/@theweeknd',
TWITTER: 'https://x.com/theweeknd',
YOUTUBE: 'https://youtube.com/@theweeknd',
APPLE: 'https://music.apple.com/us/artist/the-weeknd/479756766',
FACEBOOK: 'https://facebook.com/theweeknd',
THREADS: 'https://threads.net/@theweeknd',
BANDSINTOWN: 'https://www.bandsintown.com/a/1371750-the-weeknd'
},
pinned: true
})
};
fetch('https://api.recoupable.dev/api/artists/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.recoupable.dev/api/artists/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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',
'TIKTOK' => 'https://tiktok.com/@theweeknd',
'TWITTER' => 'https://x.com/theweeknd',
'YOUTUBE' => 'https://youtube.com/@theweeknd',
'APPLE' => 'https://music.apple.com/us/artist/the-weeknd/479756766',
'FACEBOOK' => 'https://facebook.com/theweeknd',
'THREADS' => 'https://threads.net/@theweeknd',
'BANDSINTOWN' => 'https://www.bandsintown.com/a/1371750-the-weeknd'
],
'pinned' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.recoupable.dev/api/artists/{id}"
payload := strings.NewReader("{\n \"name\": \"The Weeknd\",\n \"image\": \"https://i.scdn.co/image/abc123\",\n \"instruction\": \"Always reference the artist's R&B catalog when discussing collaborations.\",\n \"label\": \"XO / Republic Records\",\n \"knowledges\": [\n {\n \"name\": \"Artist Knowledge Base Report\",\n \"url\": \"https://arweave.net/abc123\",\n \"type\": \"text/plain\"\n }\n ],\n \"profileUrls\": {\n \"SPOTIFY\": \"https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\",\n \"INSTAGRAM\": \"https://instagram.com/theweeknd\",\n \"TIKTOK\": \"https://tiktok.com/@theweeknd\",\n \"TWITTER\": \"https://x.com/theweeknd\",\n \"YOUTUBE\": \"https://youtube.com/@theweeknd\",\n \"APPLE\": \"https://music.apple.com/us/artist/the-weeknd/479756766\",\n \"FACEBOOK\": \"https://facebook.com/theweeknd\",\n \"THREADS\": \"https://threads.net/@theweeknd\",\n \"BANDSINTOWN\": \"https://www.bandsintown.com/a/1371750-the-weeknd\"\n },\n \"pinned\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.recoupable.dev/api/artists/{id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"The Weeknd\",\n \"image\": \"https://i.scdn.co/image/abc123\",\n \"instruction\": \"Always reference the artist's R&B catalog when discussing collaborations.\",\n \"label\": \"XO / Republic Records\",\n \"knowledges\": [\n {\n \"name\": \"Artist Knowledge Base Report\",\n \"url\": \"https://arweave.net/abc123\",\n \"type\": \"text/plain\"\n }\n ],\n \"profileUrls\": {\n \"SPOTIFY\": \"https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\",\n \"INSTAGRAM\": \"https://instagram.com/theweeknd\",\n \"TIKTOK\": \"https://tiktok.com/@theweeknd\",\n \"TWITTER\": \"https://x.com/theweeknd\",\n \"YOUTUBE\": \"https://youtube.com/@theweeknd\",\n \"APPLE\": \"https://music.apple.com/us/artist/the-weeknd/479756766\",\n \"FACEBOOK\": \"https://facebook.com/theweeknd\",\n \"THREADS\": \"https://threads.net/@theweeknd\",\n \"BANDSINTOWN\": \"https://www.bandsintown.com/a/1371750-the-weeknd\"\n },\n \"pinned\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/artists/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"The Weeknd\",\n \"image\": \"https://i.scdn.co/image/abc123\",\n \"instruction\": \"Always reference the artist's R&B catalog when discussing collaborations.\",\n \"label\": \"XO / Republic Records\",\n \"knowledges\": [\n {\n \"name\": \"Artist Knowledge Base Report\",\n \"url\": \"https://arweave.net/abc123\",\n \"type\": \"text/plain\"\n }\n ],\n \"profileUrls\": {\n \"SPOTIFY\": \"https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\",\n \"INSTAGRAM\": \"https://instagram.com/theweeknd\",\n \"TIKTOK\": \"https://tiktok.com/@theweeknd\",\n \"TWITTER\": \"https://x.com/theweeknd\",\n \"YOUTUBE\": \"https://youtube.com/@theweeknd\",\n \"APPLE\": \"https://music.apple.com/us/artist/the-weeknd/479756766\",\n \"FACEBOOK\": \"https://facebook.com/theweeknd\",\n \"THREADS\": \"https://threads.net/@theweeknd\",\n \"BANDSINTOWN\": \"https://www.bandsintown.com/a/1371750-the-weeknd\"\n },\n \"pinned\": true\n}"
response = http.request(request)
puts response.read_body{
"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"
}
]
}
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}Update Artist
Update an artist. All body fields are optional, but at least one must be provided. Use this endpoint to set basic profile (name, image, label), AI instructions, knowledge base entries, social profile URLs (mapped by platform), and pinned state for the calling account.
curl --request PATCH \
--url https://api.recoupable.dev/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",
"TIKTOK": "https://tiktok.com/@theweeknd",
"TWITTER": "https://x.com/theweeknd",
"YOUTUBE": "https://youtube.com/@theweeknd",
"APPLE": "https://music.apple.com/us/artist/the-weeknd/479756766",
"FACEBOOK": "https://facebook.com/theweeknd",
"THREADS": "https://threads.net/@theweeknd",
"BANDSINTOWN": "https://www.bandsintown.com/a/1371750-the-weeknd"
},
"pinned": true
}
EOFimport requests
url = "https://api.recoupable.dev/api/artists/{id}"
payload = {
"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",
"TIKTOK": "https://tiktok.com/@theweeknd",
"TWITTER": "https://x.com/theweeknd",
"YOUTUBE": "https://youtube.com/@theweeknd",
"APPLE": "https://music.apple.com/us/artist/the-weeknd/479756766",
"FACEBOOK": "https://facebook.com/theweeknd",
"THREADS": "https://threads.net/@theweeknd",
"BANDSINTOWN": "https://www.bandsintown.com/a/1371750-the-weeknd"
},
"pinned": True
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
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',
TIKTOK: 'https://tiktok.com/@theweeknd',
TWITTER: 'https://x.com/theweeknd',
YOUTUBE: 'https://youtube.com/@theweeknd',
APPLE: 'https://music.apple.com/us/artist/the-weeknd/479756766',
FACEBOOK: 'https://facebook.com/theweeknd',
THREADS: 'https://threads.net/@theweeknd',
BANDSINTOWN: 'https://www.bandsintown.com/a/1371750-the-weeknd'
},
pinned: true
})
};
fetch('https://api.recoupable.dev/api/artists/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.recoupable.dev/api/artists/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'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',
'TIKTOK' => 'https://tiktok.com/@theweeknd',
'TWITTER' => 'https://x.com/theweeknd',
'YOUTUBE' => 'https://youtube.com/@theweeknd',
'APPLE' => 'https://music.apple.com/us/artist/the-weeknd/479756766',
'FACEBOOK' => 'https://facebook.com/theweeknd',
'THREADS' => 'https://threads.net/@theweeknd',
'BANDSINTOWN' => 'https://www.bandsintown.com/a/1371750-the-weeknd'
],
'pinned' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.recoupable.dev/api/artists/{id}"
payload := strings.NewReader("{\n \"name\": \"The Weeknd\",\n \"image\": \"https://i.scdn.co/image/abc123\",\n \"instruction\": \"Always reference the artist's R&B catalog when discussing collaborations.\",\n \"label\": \"XO / Republic Records\",\n \"knowledges\": [\n {\n \"name\": \"Artist Knowledge Base Report\",\n \"url\": \"https://arweave.net/abc123\",\n \"type\": \"text/plain\"\n }\n ],\n \"profileUrls\": {\n \"SPOTIFY\": \"https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\",\n \"INSTAGRAM\": \"https://instagram.com/theweeknd\",\n \"TIKTOK\": \"https://tiktok.com/@theweeknd\",\n \"TWITTER\": \"https://x.com/theweeknd\",\n \"YOUTUBE\": \"https://youtube.com/@theweeknd\",\n \"APPLE\": \"https://music.apple.com/us/artist/the-weeknd/479756766\",\n \"FACEBOOK\": \"https://facebook.com/theweeknd\",\n \"THREADS\": \"https://threads.net/@theweeknd\",\n \"BANDSINTOWN\": \"https://www.bandsintown.com/a/1371750-the-weeknd\"\n },\n \"pinned\": true\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.recoupable.dev/api/artists/{id}")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"The Weeknd\",\n \"image\": \"https://i.scdn.co/image/abc123\",\n \"instruction\": \"Always reference the artist's R&B catalog when discussing collaborations.\",\n \"label\": \"XO / Republic Records\",\n \"knowledges\": [\n {\n \"name\": \"Artist Knowledge Base Report\",\n \"url\": \"https://arweave.net/abc123\",\n \"type\": \"text/plain\"\n }\n ],\n \"profileUrls\": {\n \"SPOTIFY\": \"https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\",\n \"INSTAGRAM\": \"https://instagram.com/theweeknd\",\n \"TIKTOK\": \"https://tiktok.com/@theweeknd\",\n \"TWITTER\": \"https://x.com/theweeknd\",\n \"YOUTUBE\": \"https://youtube.com/@theweeknd\",\n \"APPLE\": \"https://music.apple.com/us/artist/the-weeknd/479756766\",\n \"FACEBOOK\": \"https://facebook.com/theweeknd\",\n \"THREADS\": \"https://threads.net/@theweeknd\",\n \"BANDSINTOWN\": \"https://www.bandsintown.com/a/1371750-the-weeknd\"\n },\n \"pinned\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.recoupable.dev/api/artists/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"The Weeknd\",\n \"image\": \"https://i.scdn.co/image/abc123\",\n \"instruction\": \"Always reference the artist's R&B catalog when discussing collaborations.\",\n \"label\": \"XO / Republic Records\",\n \"knowledges\": [\n {\n \"name\": \"Artist Knowledge Base Report\",\n \"url\": \"https://arweave.net/abc123\",\n \"type\": \"text/plain\"\n }\n ],\n \"profileUrls\": {\n \"SPOTIFY\": \"https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ\",\n \"INSTAGRAM\": \"https://instagram.com/theweeknd\",\n \"TIKTOK\": \"https://tiktok.com/@theweeknd\",\n \"TWITTER\": \"https://x.com/theweeknd\",\n \"YOUTUBE\": \"https://youtube.com/@theweeknd\",\n \"APPLE\": \"https://music.apple.com/us/artist/the-weeknd/479756766\",\n \"FACEBOOK\": \"https://facebook.com/theweeknd\",\n \"THREADS\": \"https://threads.net/@theweeknd\",\n \"BANDSINTOWN\": \"https://www.bandsintown.com/a/1371750-the-weeknd\"\n },\n \"pinned\": true\n}"
response = http.request(request)
puts response.read_body{
"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"
}
]
}
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}{
"status": "error",
"error": "<string>",
"missing_fields": [
"<string>"
]
}Path Parameters
Artist account ID to update.
Body
Fields to update. At least one field must be provided.
All fields are optional. The request must include at least one field.
Artist display name
"The Weeknd"
Artist profile image URL. Pass an empty string to clear the existing image; otherwise must be a valid URL.
"https://i.scdn.co/image/abc123"
Custom AI instruction shown to assistants when this artist is the active context
"Always reference the artist's R&B catalog when discussing collaborations."
Record label name
"XO / Republic Records"
Knowledge base entries for this artist. Replaces the existing array when provided.
Show child attributes
Show child attributes
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, BANDSINTOWN. Keys are matched case-sensitively, so lowercase keys will create duplicate socials instead of replacing the existing entry.
Show child attributes
Show child attributes
{
"SPOTIFY": "https://open.spotify.com/artist/1Xyo4u8uXC1ZmMpatF05PJ",
"INSTAGRAM": "https://instagram.com/theweeknd",
"TIKTOK": "https://tiktok.com/@theweeknd",
"TWITTER": "https://x.com/theweeknd",
"YOUTUBE": "https://youtube.com/@theweeknd",
"APPLE": "https://music.apple.com/us/artist/the-weeknd/479756766",
"FACEBOOK": "https://facebook.com/theweeknd",
"THREADS": "https://threads.net/@theweeknd",
"BANDSINTOWN": "https://www.bandsintown.com/a/1371750-the-weeknd"
}
Pin or unpin the artist for the authenticated account. Affects only the caller's pin state, not other accounts.
Response
Artist updated successfully
Show child attributes
Show child attributes
Was this page helpful?
