Skip to main content
POST
Creates multiple items in a single transaction.

Headers

X-Delogue-Api
string

Body

id
null | integer<int64>

Optional client-supplied identifier. Ignored on create; the server assigns the id.

name
null | string

Display name of the item. Required, and limited to 200 characters.

customId
null | string

Customer-defined item number. Limited to 100 characters.

description
null | string

Free-text description of the item, such as a supplier article number. Limited to 1000 characters.

brand
null | object

Brand this item belongs to. Supply the brand id; its name and customId are echoed back unchanged.

supplier
null | object

Supplier organisation to assign to this item. Supply the supplier id; its name and customId are echoed back unchanged.

companyContactPerson
null | object

Brand-side contact person for the item. Supply the user's GUID id. Defaults to the brand's contact person when omitted.

supplierContactPerson
null | object

Supplier-side contact person for the item. Supply the user's GUID id. Defaults to the supplier's contact person when omitted.

defaultQty

Default consumption quantity applied when the item is added to a style. Must not be negative.

nameGeneratorExtraText
null | string

Extra text supplied to the item number generator when a number-generation rule is configured.

readyForExport
null | boolean

When true, the item is validated against mandatory custom fields and marked ready for export. Defaults to false.

categories
null | object[]

Item categories to assign. Each entry is matched by its category id.

customFields
null | object[]

Custom field values to set on the item. Each custom field may appear at most once.

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.