Skip to main content
GET
/
defaultsettings
/
{entityType}
Get Default Settings (Tenant/Catalog Level)
curl --request GET \
  --url https://api.royalti.io/defaultsettings/{entityType} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Default settings retrieved successfully",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "TenantId": 1,
      "entityType": "tenant",
      "entityId": null,
      "category": "content",
      "settings": {
        "content": {
          "type": "Audio",
          "format": "Single",
          "mainGenre": [
            "Pop",
            "Electronic"
          ]
        }
      },
      "isActive": true,
      "priority": 0,
      "createdAt": "2024-01-01T00:00:00Z",
      "updatedAt": "2024-01-01T00:00:00Z"
    }
  ]
}

​
Description

GET /defaultsettings/ Description: Retrieve default settings for tenant or catalog level entities. This endpoint is used when no specific entity ID is needed. Entity Types (for this endpoint):
  • tenant - Workspace-wide defaults
  • catalog - Catalog-level defaults
Note: For label, artist, or user-specific defaults, use the GET /defaultsettings/{entityType}/{entityId} endpoint instead. Method: GET Path Parameters:
ParameterTypeDescriptionRequired
entityTypestringType of entity (tenant or catalog)Yes
Query Parameters:
ParameterTypeDescriptionRequired
categorystringFilter by category (content, business, ddex, validation)No
includeInactivebooleanInclude inactive settingsNo

​
Code Examples

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

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

Query Parameters

​
category
enum<string>

Filter by settings category

Available options:
content,
business,
ddex,
validation
​
includeInactive
boolean
default:false

Include inactive settings in results

Response

Successfully retrieved default settings

​
success
boolean
Example:

true

​
message
string
Example:

"Default settings retrieved successfully"

​
data
object[]