API ReferenceCategories Tags

Create Material Category

Creates a new material category. Optionally nest under a parent by supplying parentId.

Requires scope: categories:write

Authentication

API_KEYstring
API Key authentication via header

Request

This endpoint expects an object.
namestringRequired
Display name for the category. Required. Maximum 255 characters.
parentIdUUIDOptional

ID of the parent category. Omit or pass null for a top-level category.

Response

This endpoint returns an object.
idUUID
Unique identifier for the category.
namestring
Display name of the category.
subCategorieslist of objects
Immediate child categories nested under this category.
typestring
Category type classification.
parentIdUUID

ID of the parent category, if this is a sub-category.

updatedAtdatetime
ISO 8601 timestamp when the record was last updated.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error