Skip to main content
DELETE
/
asset
/
{id}
/
media
/
{mediaName}
Delete media for an asset
curl --request DELETE \
  --url https://api.royalti.io/asset/{id}/media/{mediaName} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Media deleted successfully"
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

Required Permissions:
  • User must be authenticated
  • User must have appropriate permissions to modify the asset
Note: This operation permanently removes the media file from both storage and the asset’s media array.

​
Code Examples

const response = await fetch('https://api.royalti.io/asset/example-id/media/example-id', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

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<uuid>
required

The unique identifier of the asset

​
mediaName
string
required

The name of the media file to delete

Response

Media deleted successfully

​
message
string
Example:

"Media deleted successfully"