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 '{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "type": "Audio",
  "isrc": "<string>",
  "iswc": "<string>",
  "displayArtist": "<string>",
  "mainArtist": [
    "<string>"
  ],
  "version": "<string>",
  "mainGenre": [
    "<string>"
  ],
  "subGenre": [
    "<string>"
  ],
  "externalId": "<string>",
  "contributors": {
    "producers": [
      "<string>"
    ],
    "mixers": [
      "<string>"
    ]
  },
  "artists": [
    "<string>"
  ],
  "splits": [
    {
      "user": "<string>",
      "share": 123
    }
  ],
  "isDraft": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}'
{
  "success": true,
  "message": "Asset created successfully",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Example Song",
    "type": "Audio",
    "isDraft": false,
    "createdAt": "2023-01-01T12:00:00Z"
  }
}
Create a new asset with the provided details. This endpoint allows you to create a new asset with properties like title, artist information, and metadata. Required Fields:
  • title
  • mainArtist
  • displayArtist
Optional Fields:
  • type (default: β€˜Audio’)
  • version
  • isrc
  • iswc
  • mainGenre
  • subGenre
  • contributors
  • artists
  • splits

Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

Request Body

Responses

βœ… 201 - Asset created successfully

⚠️ 400 - undefined

⚠️ 401 - undefined

❌ 500 - undefined

Tags

Asset

Authorizations

Authorization
string
header
required

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

Body

application/json
id
string<uuid>
title
string
type
enum<string>
Available options:
Audio,
Video,
Other
isrc
string
iswc
string
displayArtist
string
mainArtist
string[]
version
string
mainGenre
string[]
subGenre
string[]
externalId
string
contributors
object
artists
string[]
splits
object[]
isDraft
boolean
createdAt
string<date-time>
updatedAt
string<date-time>

Response

Asset created successfully

success
boolean
Example:

true

message
string
data
object
⌘I