Skip to main content
POST
/
defaultsettings
/
preview
/
resolve
Preview Resolved Defaults
curl --request POST \
  --url https://api.royalti.io/defaultsettings/preview/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "artistId": "660e8400-e29b-41d4-a716-446655440001",
  "labelId": "770e8400-e29b-41d4-a716-446655440002",
  "targetType": "release"
}
'
{
  "success": true,
  "message": "Defaults resolved successfully",
  "data": {
    "resolved": {
      "content": {
        "type": "Audio",
        "format": "Single",
        "version": "<string>",
        "explicit": "explicit",
        "language": "<string>",
        "mainGenre": [
          "<string>"
        ],
        "subGenre": [
          "<string>"
        ],
        "contributors": {}
      },
      "business": {
        "label": "<string>",
        "copyright": "<string>",
        "publisher": "<string>",
        "copyrightOwner": "<string>",
        "distribution": "<string>",
        "status": "Live"
      },
      "ddex": {
        "enableDDEX": true,
        "labelName": "<string>",
        "resourceReference": "<string>",
        "grid": "<string>",
        "icpn": "<string>"
      },
      "validation": {
        "requireGenre": true,
        "requireLyrics": true,
        "requireDescription": true,
        "minimumTrackCount": 1,
        "maximumTrackCount": 2
      }
    },
    "chain": [
      {
        "entityType": "<string>",
        "entityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "category": "<string>",
        "settings": {
          "content": {
            "type": "Audio",
            "format": "Single",
            "version": "<string>",
            "explicit": "explicit",
            "language": "<string>",
            "mainGenre": [
              "<string>"
            ],
            "subGenre": [
              "<string>"
            ],
            "contributors": {}
          },
          "business": {
            "label": "<string>",
            "copyright": "<string>",
            "publisher": "<string>",
            "copyrightOwner": "<string>",
            "distribution": "<string>",
            "status": "Live"
          },
          "ddex": {
            "enableDDEX": true,
            "labelName": "<string>",
            "resourceReference": "<string>",
            "grid": "<string>",
            "icpn": "<string>"
          },
          "validation": {
            "requireGenre": true,
            "requireLyrics": true,
            "requireDescription": true,
            "minimumTrackCount": 1,
            "maximumTrackCount": 2
          }
        },
        "priority": 123
      }
    ]
  }
}

​
Description

POST /defaultsettings/preview/resolve Description: Preview how defaults will be resolved through the inheritance chain for a given context (user, artist, label). This endpoint doesn’t modify any data. Method: POST Request Body:
ParameterTypeDescriptionRequired
labelIduuidLabel contextNo
artistIduuidArtist contextNo
userIduuidUser context (defaults to authenticated user)No
targetTypestringTarget type (asset, product, release)No

​
Code Examples

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

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>
​
targetType
enum<string>
Available options:
asset,
product,
release

Response

Defaults resolved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Defaults resolved successfully"

​
data
object

Result of default settings resolution