Create a new item category

POST

/v1/item-categories

Creates a new item category. Optionally nest it under a parent category by providing a non-empty parentId. ChildTreeLevel and FullName are computed server-side.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Category created successfully

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://dev.api.fieldedge.com/open-api/v1/item-categories' \
--header 'Content-Type: application/json' \
--data '{
    "name": "HVAC",
    "active": true,
    "imageUrl": "https://cdn.example.com/categories/hvac.png",
    "parentId": "00000000-0000-0000-0000-000000000000"
}'

Response Example

201 - response

{
    "data": {
        "categoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "createdAt": "2026-05-15T14:30:00Z"
    }
}

Modified at 2026-05-21 10:40:18

Retrieve item category by id.

Partially update an item category