Skip to main content
POST
Creates one or more style custom field definitions.

Headers

X-Delogue-Api
string

Body

name
string

Display name of the custom field. Required.

userDefinedId
null | string

Optional user-defined identifier for referencing the field in imports, exports, and integrations.

type
enum<string>

Field type that determines the input control and the kind of value the field accepts.

Available options:
allowedValue,
date,
text,
nestedAllowedValue,
numeric,
divider
position

Ordering position of the field among the style custom fields. Lower values appear first.

state
enum<string>

Initial lifecycle state of the field. Defaults to active, and the deleted state is rejected on create.

Available options:
active,
inactive,
deleted
internalOnly
boolean

When true, the field is hidden from supplier users.

isMandatory
boolean

When true, the field must be filled in before a style can be marked ready for export.

isSupplierEditable
boolean

When true, supplier users are allowed to edit this field's value on a style.

isMultiLine
boolean

For text fields, when true the field is shown as a multi-line text box instead of a single-line input.

isSortByAllowedValueId
boolean

For allowed-value fields, when true the options are ordered by their user-defined code rather than by display text.

diffPerColor
boolean

When true, the field can hold a separate value for each color of a style.

diffPerSize
boolean

When true, the field can hold a separate value for each size of a style.

useInThumbnailViewGroupBy
boolean

When true, styles can be grouped by this field's value in the thumbnail view.

maxChar

Optional maximum number of characters allowed for the field's value. Must be positive when set.

allowedDecimals

For numeric fields, the number of decimal places permitted. Defaults to 0 for whole numbers only.

numericVariantCalculationFormula
enum<string>

For numeric fields differentiated per color or size, controls how the per-variant values are aggregated in reporting.

Available options:
none,
average,
sum
parentCustomFieldId
null | integer<int64>

For a nested allowed-value field, the identifier of the parent field that supplies the top-level options. Null for top-level fields.

allowedValues
null | object[]

Selectable options for an allowed-value or nested allowed-value field. Omit or send null to create the field with no options.

associatedBrands
null | object[]

Brands to restrict the field to. Omit or send null to make the field available on styles of any brand.

associatedGroups
null | object[]

Style groups to restrict the field to. Omit or send null to make the field available on styles in any group.

associatedStyleCategories
null | object[]

Style categories to restrict the field to. Omit or send null to make the field available on styles in any category.

Response

Created

status
enum<string>
required

The coarse outcome of the request, indicating whether it succeeded or failed.

Available options:
success,
error
code
string
required

The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire.

data
null | object[]
required

The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value.