Save artist profile with fresh ownership and version checks

POST

/v1/artists/{key}/profile

curl --request POST \
  --url https://api.digirare.com/v1/artists/example/profile \
  --header 'Content-Type: application/json' \
  --header 'x-session-token: <x-session-token>' \
  --data '{ "name": "example", "slug": "example", "bio": "example", "website": "example", "x_url": "example", "version": 1 }'

Authorizations

• session

Parameters

Path Parameters

key

required

string

Header Parameters

x-session-token

required

string

Request Body^required

Media typeapplication/json

object

name

required

string

<= 100 characters

slug

required

string

<= 200 characters

bio

required

string

<= 500 characters

website

required

string

<= 500 characters

x_url

required

string

<= 500 characters

version

required

integer

Example^generated

{
  "name": "example",
  "slug": "example",
  "bio": "example",
  "website": "example",
  "x_url": "example",
  "version": 1
}

Responses

200

Success

Media typeapplication/json

object

result

required

object

name

required

string

key

required

string

assets

required

integer

listed

required

integer

floor_sats

required

integer | null

collections

required

Array<object>

object

slug

required

string

name

required

string

assets

required

integer

id

required

string

bio

required

string

website

required

string

x_url

required

string

version

required

integer

Example^generated

{
  "result": {
    "name": "example",
    "key": "example",
    "assets": 1,
    "listed": 1,
    "floor_sats": 1,
    "collections": [
      {
        "slug": "example",
        "name": "example",
        "assets": 1
      }
    ],
    "id": "example",
    "bio": "example",
    "website": "example",
    "x_url": "example",
    "version": 1
  }
}

400

Invalid input

401

Wallet session required

403

Wallet ineligible

404

Artist missing

409

Profile changed or URL reserved

429

Rate limited

503

Ownership unavailable