Skip to main content
POST
Create Default Setting (Tenant/Catalog Level)

Description

POST /defaultsettings/ Description: Create a new default setting for tenant or catalog level. Each entity can have one setting per category. Entity Types (for this endpoint):
  • tenant - Workspace-wide defaults
  • catalog - Catalog-level defaults
Note: For label, artist, or user-specific defaults, use the POST /defaultsettings/{entityType}/{entityId} endpoint instead. Authorization:
  • Required role: admin or higher
Validation:
  • 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 (tenant or catalog only)

Available options:
tenant,
catalog

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