Categories / Create
Creates new category..
Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/categories
Method: POST
Authorisation: Minimum role: ADMIN
Response object
Response status: 200 (OK)
Response type: DTO_category
Wrapper: DTO_response_wrap
Other response statuses: 400 (BadRequest), 403 (Forbidden)
Response body example
DTO_category
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| created_by | DTO_reference_user | ReadOnly | Created by |
| last_updated_by | DTO_reference_user | ReadOnly | Last updated by |
| children | DTO_category[] | ReadOnly | Children |
| id | Int32 | ReadOnly | Leave empty when Creating object |
| parent_id | Int32 | Parent id | |
| name | String | Name | |
| name_path | String[] | ReadOnly | Name path |
| unique_key | String | Unique key | |
| description | String | Description | |
| visibility | ENUM category_visibility | Visibility | |
| icon_id | Int32 | Icon id | |
| icon_file | String | ReadOnly | Icon file |
| created | DateTime | ReadOnly | Created |
| last_updated | DateTime | ReadOnly | Last updated |
DTO_reference_user
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| profile_pic | String | ReadOnly | Profile pic |
| String | ReadOnly | ||
| id | Int32 | Id | |
| label | Object | ReadOnly | Label |
DTO_category
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| created_by | DTO_reference_user | ReadOnly | Created by |
| last_updated_by | DTO_reference_user | ReadOnly | Last updated by |
| children | DTO_category[] | ReadOnly | Children |
| id | Int32 | ReadOnly | Leave empty when Creating object |
| parent_id | Int32 | Parent id | |
| name | String | Name | |
| name_path | String[] | ReadOnly | Name path |
| unique_key | String | Unique key | |
| description | String | Description | |
| visibility | ENUM category_visibility | Visibility | |
| icon_id | Int32 | Icon id | |
| icon_file | String | ReadOnly | Icon file |
| created | DateTime | ReadOnly | Created |
| last_updated | DateTime | ReadOnly | Last updated |
ENUM category_visibility
| Value | Name | Description |
|---|---|---|
| 0 | UNKNOWN | UNKNOWN |
| 1 | INTERNAL | INTERNAL |
| 2 | HELP_CENTER | HELP CENTER |