Skip to main content
DELETE
/
file
/
royalty
/
{id}
Delete royalty file and associated BigQuery table
curl --request DELETE \
  --url https://api.royalti.io/file/royalty/{id} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "Royalty file deleted successfully",
  "data": {
    "fileId": "file-uuid-123",
    "fileName": "export.csv",
    "tableName": "royalty_uploads_2024_01_15",
    "dataset": "royalty_data",
    "bigQueryDeleted": true,
    "storageFileDeleted": true,
    "databaseRecordDeleted": true,
    "deletedAt": "2024-01-15T10:30:00.000Z",
    "errors": []
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

This operation cannot be undone. User accounting records are preserved. Admin/Owner access required.

​
Code Examples

const response = await fetch('https://api.royalti.io/file/royalty/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 UUID of the royalty file to delete

Response

File deleted successfully

​
status
string
Example:

"success"

​
message
string
Example:

"Royalty file deleted successfully"

​
data
object