Skip to main content
POST
/
asset
Create a new asset
curl --request POST \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/asset \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Midnight City",
  "mainArtist": [
    "M83",
    "M47"
  ],
  "displayArtist": "M83",
  "type": "Audio",
  "version": "Album Version",
  "isrc": "USRC17607839",
  "iswc": "T1234567890",
  "mainGenre": [
    "Electronic",
    "Mental"
  ],
  "subGenre": [
    "Synthwave"
  ],
  "explicit": false,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "artists": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "primary"
    }
  ],
  "split": [
    {
      "user": "550e8400-e29b-41d4-a716-446655440002",
      "share": 100
    }
  ],
  "externalId": "<string>",
  "contributors": {
    "producers": [
      "<string>"
    ],
    "mixers": [
      "<string>"
    ]
  }
}'
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Example Song",
    "type": "Audio",
    "isDraft": false,
    "ddexMetadata": null,
    "focusTrack": false,
    "media": [],
    "explicit": null,
    "TenantId": 2,
    "mainArtist": [
      "M83",
      "M47"
    ],
    "displayArtist": "M83",
    "version": "Album Version",
    "mainGenre": [
      "Electronic",
      "Mental"
    ],
    "subGenre": [
      "Synthwave"
    ],
    "contributors": {
      "producers": [
        "string"
      ],
      "mixers": [
        "string"
      ]
    },
    "iswc": "T1234567890",
    "externalId": "string",
    "isrc": "USRC17607839",
    "updatedAt": "2025-08-21T11:42:29.827Z",
    "createdAt": "2025-08-21T11:42:29.827Z",
    "assetIDs": "null,",
    "otherArtist": "null,",
    "lyrics": "null,",
    "extra": "null,",
    "danceStyle": "null,",
    "rhythmStyle": "null,",
    "instrumentation": "null,",
    "recordingLocation": "null,",
    "recordingDate": "null,",
    "alternativeTitles": "null,",
    "chartPositions": "null,",
    "reviews": "null,",
    "awards": "null,",
    "socialMediaHandles": "null,",
    "language": "null,",
    "mood": "null,",
    "tempo": "null,",
    "key": "null,",
    "copyrightOwner": "null,",
    "productionYear": "null,",
    "metadata": null
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://server26-dot-royalti-project.uc.r.appspot.com/asset', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "ref": "#/components/schemas/Asset"
  })
});

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
​
title
string
required
Example:

"Midnight City"

​
mainArtist
string[]
required
Example:
["M83", "M47"]
​
displayArtist
string
required
Example:

"M83"

​
type
enum<string>
default:Audio
required
Available options:
Audio,
Video
Example:

"Audio"

​
version
string
Example:

"Album Version"

​
isrc
string
Example:

"USRC17607839"

​
iswc
string
Example:

"T1234567890"

​
mainGenre
string[]
Example:
["Electronic", "Mental"]
​
subGenre
string[]
Example:
["Synthwave"]
​
explicit
boolean
default:false
​
id
string<uuid>
​
artists
object[]
Example:
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "primary"
  }
]
​
split
object[]
Example:
[
  {
    "user": "550e8400-e29b-41d4-a716-446655440002",
    "share": 100
  }
]
​
externalId
string
​
contributors
object

Response

Asset created successfully

​
success
boolean
Example:

true

​
message
string
​
data
object