API ReferenceCategories

Update Material Category

Updates an existing material category.

Requires scope: categories:write

Authentication

API_KEYstring
API Key authentication via header

Path parameters

idUUIDRequired
Category ID.

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.
typestringOptional
Category type classification.
parentIdUUIDOptional

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

updatedAtdatetimeOptional
ISO 8601 timestamp when the record was last updated.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Rate Limit Error