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

​
Description

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

​
Code Examples

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

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>
​
releaseData
object

Partial release data to merge with defaults

Response

Release preview generated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Release preview generated successfully"

​
data
object

Preview of how defaults would be applied