Brands / Create
Create new brand
Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/brands
Method: POST
Authorisation: Minimum role: USER
Response object
Response status: 200 (OK)
Response type: DTO_brand
Wrapper: DTO_response_wrap
Other response statuses: 400 (BadRequest), 403 (Forbidden)
Response body example
DTO_brand
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| user_brands | DTO_reference_brand_user[] | User brands | |
| created_by | DTO_reference_user | ReadOnly | Created by |
| last_updated_by | DTO_reference_user | ReadOnly | Last updated by |
| id | Int32 | ReadOnly | Leave empty on input |
| name | String | Name | |
| tenant | DTO_reference | ReadOnly | Tenant |
| created | DateTime | ReadOnly | Created |
| last_updated | DateTime | ReadOnly | Last updated |
| current_user_role | brand_user_role (nullable) | ReadOnly | The current user's effective brand role on this brand, after tenant → brand short-circuit. Tenant OWNER/ADMIN and SUPER_ADMIN are projected as USER. |
| is_active | Boolean | ReadOnly | Is active |
DTO_reference_brand_user
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| brand_role_enum_id | brand_user_role (nullable) | Per-brand role for the user, when this reference appears inside a brand's user_brands list. | |
| profile_pic | String | ReadOnly | Profile pic |
| String | ReadOnly | ||
| role_enum_id | tenant_user_role (nullable) | Role enum id | |
| id | Int32 | Id | |
| label | Object | ReadOnly | Label |
DTO_reference_user
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| profile_pic | String | ReadOnly | Profile pic |
| String | ReadOnly | ||
| role_enum_id | tenant_user_role (nullable) | Role enum id | |
| id | Int32 | Id | |
| label | Object | ReadOnly | Label |
DTO_reference
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| id | Int32 | The id of the reference | |
| label | Object | ReadOnly | Name/Label from referenced object. |
