Skip to main content
POST
/
product
/
{id}
/
media
Upload Product Media
curl --request POST \
  --url https://api.royalti.io/product/{id}/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'mediaType=<string>'
{
  "message": "Media uploaded successfully",
  "mediaUrl": "https://storage.example.com/media/product-123/artwork.jpg"
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

/product//media Description:
The /product/{id}/media endpoint allows uploading media files associated with a specific product. Method:
POST Path Parameter:
ParameterTypeDescription
idstringThe unique identifier of the product.
Request Payload:
ParameterTypeDescription
filefileThe media file to upload.
mediaTypestringThe type of media (e.g., artwork, video, audio).

​
Code Examples

const response = await fetch('https://api.royalti.io/product/example-id/media', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
});

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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Product ID

Body

multipart/form-data
​
file
file
required

The media file to upload

​
mediaType
string
required

The type of media (e.g., artwork, video, audio)

Response

Success

​
message
string
​
mediaUrl
string