Skip to main content
POST
Create Default Setting (Entity-Specific)

Description

POST /defaultsettings// Description: Create a new default setting for a specific entity (label, artist, or user). Each entity can have one setting per category. Entity Types (for this endpoint):
  • label - Label-specific defaults (entityId required)
  • artist - Artist-specific defaults (entityId required)
  • user - User-specific defaults (entityId required)
Note: For tenant or catalog-level defaults, use the POST /defaultsettings/{entityType} endpoint instead (without entityId). Authorization:
  • Required role: admin or higher
Validation:
  • Entity must exist (for label/artist/user types)
  • Only one setting per entity + category combination
  • Settings are automatically validated against the category schema
Method: POST Path Parameters: Request Body:

Code Examples

Authorizations

Authorization
string
header
required

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

Path Parameters

entityType
enum<string>
required

Type of entity (label, artist, or user only)

Available options:
label,
artist,
user
entityId
string<uuid>
required

Entity ID

Body

application/json
category
enum<string>
required

Category of settings

Available options:
content,
business,
ddex,
validation
settings
object
required

The actual settings data organized by category

priority
integer
default:0

Priority for conflict resolution

Response

Default setting created successfully

success
boolean
Example:

true

message
string
Example:

"Default setting created successfully"

data
object

A default setting entry