curl --fail-with-body -X PATCH "$RAWCHUNKS_API/api/songs/$(jq -nr --arg v "$ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS" \
-H "Content-Type: application/json" \
--data "$(jq -nc '{
"title": "Night circuit",
"tags": [
"acid house"
],
"public": false
}')"
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
}Songs and takes
Update a song
Update an owned song’s metadata or catalog fields.
PATCH
/
api
/
songs
/
{id}
curl --fail-with-body -X PATCH "$RAWCHUNKS_API/api/songs/$(jq -nr --arg v "$ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS" \
-H "Content-Type: application/json" \
--data "$(jq -nc '{
"title": "Night circuit",
"tags": [
"acid house"
],
"public": false
}')"
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
}Send at least one recognized field. Audio or arrangement changes on a minted song require an editable version. Chain fields record a confirmed mint; changing them does not execute or prove a mint.
Publish an original.
Headers and parameters
string
required
Resource ID.
string
required
Selected account address. Required for owner-scoped reads and writes. It identifies the account; your product must authenticate its own users.
JSON body
string
Nonempty title. Minimum length:
1.integer
string | null
string
integer
number
Listed USDC per minute.
number
Listed USDC per license.
number | null
Seconds.
string[]
string | null
string | null
string | null
boolean
Catalog visibility. Media URLs are not private storage.
string | null
string | null
string | null
Response (200)
Success.string
required
string
required
string
required
string
required
string
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
integer
integer
number
Listed USDC per minute.
number
Listed USDC per license.
number | null
Seconds.
string[]
boolean
Catalog visibility. Media URLs are not private storage.
Errors
Failed JSON responses contain anerror string. Check the HTTP status before reading a successful result. See job handling for interrupted or uncertain submissions.
| Status | Meaning |
|---|---|
400 | Invalid request. |
403 | Account does not match resource. |
404 | Resource not found. |
409 | Resource conflict; reload state or open an editable version. |
500 | Request failed. |
curl --fail-with-body -X PATCH "$RAWCHUNKS_API/api/songs/$(jq -nr --arg v "$ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS" \
-H "Content-Type: application/json" \
--data "$(jq -nc '{
"title": "Night circuit",
"tags": [
"acid house"
],
"public": false
}')"
⌘I