Skip to main content
DELETE
/
defaultsettings
/
{entityType}
/
{settingId}
Delete Default Setting (Tenant/Catalog Level)
curl --request DELETE \
  --url https://api.royalti.io/defaultsettings/{entityType}/{settingId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Default setting deleted successfully"
}

​
Description

DELETE /defaultsettings// Description: Permanently delete a default setting for tenant or catalog level. This action cannot be undone. Entity Types (for this endpoint):
  • tenant - Workspace-wide defaults
  • catalog - Catalog-level defaults
Note: For label, artist, or user-specific defaults, use the DELETE /defaultsettings/{entityType}/{entityId}/{settingId} endpoint instead. Method: DELETE Path Parameters:
ParameterTypeDescriptionRequired
entityTypestringType of entity (tenant or catalog)Yes
settingIduuidID of the setting to deleteYes

​
Code Examples

const response = await fetch('https://api.royalti.io/defaultsettings/example-id/example-id', {
  method: 'DELETE',
});

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

​
entityType
enum<string>
required

Type of entity (tenant or catalog only)

Available options:
tenant,
catalog
​
settingId
string<uuid>
required

ID of the setting to delete

Response

Default setting deleted successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Default setting deleted successfully"