Skip to main content
POST
/
defaultsettings
/
preview
/
product
Preview Product Defaults
curl --request POST \
  --url https://api.royalti.io/defaultsettings/preview/product \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "artistId": "660e8400-e29b-41d4-a716-446655440001",
  "productData": {
    "productName": "New Album",
    "releaseDate": "2024-12-01"
  }
}
'
{
  "success": true,
  "message": "Product preview generated successfully",
  "data": {
    "original": {},
    "withDefaults": {},
    "appliedDefaults": [
      {
        "field": "<string>",
        "value": "<unknown>",
        "source": {
          "entityType": "<string>",
          "entityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "category": "<string>"
        }
      }
    ]
  }
}

​
Description

POST /defaultsettings/preview/product Description: Preview how defaults will be applied to a product. Method: POST Request Body:
ParameterTypeDescriptionRequired
labelIduuidLabel contextNo
artistIduuidArtist contextNo
userIduuidUser contextNo
productDataobjectPartial product data to testNo

​
Code Examples

const response = await fetch('https://api.royalti.io/defaultsettings/preview/product', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "labelId": "sample-labelId",
    "artistId": "sample-artistId",
    "userId": "sample-userId",
    "productData": {}
  })
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
​
labelId
string<uuid>
​
artistId
string<uuid>
​
userId
string<uuid>
​
productData
object

Partial product data to merge with defaults

Response

Product preview generated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Product preview generated successfully"

​
data
object

Preview of how defaults would be applied