Skip to main content
POST
Creates one or more item categories.

Headers

X-Delogue-Api
string

Body

name
string

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

state
enum<string>

Initial lifecycle state of the new category. Defaults to active when omitted; pass inactive to create it deactivated. Creating in the deleted state is rejected with a 400.

Available options:
active,
inactive,
deleted

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.