Skip to main content
PUT
Bulk-updates and/or soft-deletes style custom field definitions in a single transaction.

Headers

X-Delogue-Api
string

Body

id
integer<int64>
required

Identifier of the style custom field to update. Required for every item in a bulk update.

name
null | string

New display name for the field. Required on a full replace.

userDefinedId
null | string

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

state
null | enum<string>

New lifecycle state for the field. Required on a full replace. PUT and PATCH /api/style-custom-fields/{id} reject deleted with 400; on the bulk PUT /api/style-custom-fields, deleted soft-deletes the field.

Available options:
active,
inactive,
deleted
position

Read-only ordering position; it cannot be changed here, and supplying a non-null value is rejected.

internalOnly
null | boolean

When true, the field is hidden from supplier users.

isMandatory
null | boolean

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

isSupplierEditable
null | boolean

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

isMultiLine
null | boolean

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

isSortByAllowedValueId
null | boolean

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

diffPerColor
null | boolean

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

diffPerSize
null | boolean

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

useInThumbnailViewGroupBy
null | boolean

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

maxChar

Maximum number of characters allowed for the field's value. Null means no limit.

allowedDecimals

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

numericVariantCalculationFormula
null | 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
allowedValues
null | object[]

Complete set of allowed options for the field. On a full replace it replaces the existing options, and an empty array clears them all.

associatedBrands
null | object[]

Complete set of brands the field is restricted to. On a full replace it replaces existing associations, and an empty array removes all brand restrictions.

associatedGroups
null | object[]

Complete set of style groups the field is restricted to. On a full replace it replaces existing associations, and an empty array removes all group restrictions.

associatedStyleCategories
null | object[]

Complete set of style categories the field is restricted to. On a full replace it replaces existing associations, and an empty array removes all category restrictions.

Response

OK

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.