Create Brand

Creates a new brand with the specified properties.

HTTP Request

POST/api/products/brands

Authorization

Authorization

• Required: Yes
• Permission: Staff or Admin
• Authentication: Token-based (Authorization: Token <your_api_key>)

Request Body

Field	Type	Required	Description
name	String	Yes	Brand name (must be unique)
slug	String	No	URL-friendly version of the brand name (auto-generated if not provided)
image	Integer	No	ID of the brand image
order	Integer	No	Display order for brand sorting
description	String	No	Brand description (max 500 characters)

Example Requests

🐍 Python

1import requests
2
3# Create a new brand
4response = requests.post('http://www.example.com/api/products/brands', 
5  json={
6      'name': 'Nike',
7      'image': 123,
8      'order': 1,
9      'description': 'Just Do It - Global athletic footwear and apparel company'
10  },
11  headers={'Authorization': 'Token <your_api_key>'}
12)
13print(response.json())
14
15# Create minimal brand
16response = requests.post('http://www.example.com/api/products/brands', 
17  json={
18      'name': 'Adidas'
19  },
20  headers={'Authorization': 'Token <your_api_key>'}
21)
22print(response.json())

🌐 Curl

1# Create a new brand
2curl -X POST "http://www.example.com/api/products/brands" \
3-H "Authorization: Token <your_api_key>" \
4-H "Content-Type: application/json" \
5-d '{
6  "name": "Nike",
7  "image": 123,
8  "order": 1,
9  "description": "Just Do It - Global athletic footwear and apparel company"
10}'
11
12# Create minimal brand
13curl -X POST "http://www.example.com/api/products/brands" \
14-H "Authorization: Token <your_api_key>" \
15-H "Content-Type: application/json" \
16-d '{
17  "name": "Adidas"
18}'

Status Codes

Code	Description
201	Brand created successfully
400	Bad request — invalid input or duplicate name
401	Unauthorized — authentication required
403	Forbidden — insufficient permissions
500	Internal server error

Response Fields

Field	Type	Description
id	Integer	Unique ID of the brand
image_data	Object	Brand image details (read-only)
order	Integer	Display order for brand sorting
name	String	Brand name (unique)
slug	String	URL-friendly version of the brand name
description	String	Brand description (max 500 characters)
products_count	Integer	Number of products associated with brand
created_at	String (ISO 8601)	Timestamp when brand was created
updated_at	String (ISO 8601)	Timestamp when brand was last updated

Image Data Structure

Field	Type	Description
id	Integer	Image ID
type	String	File type
name	String	Image file name
size	Integer	File size in bytes
human_readable_size	String	Human readable file size
f	String	Image file URL
width	Integer	Image width in pixels
height	Integer	Image height in pixels
mode	String	Image color mode