Create Portfolio Employer

Creates a new portfolio employer with the specified properties.

HTTP Request

POST/api/portfolios/employers/

NOTE: NOT USING THE TRAILING SLASH AT THE END OF THE URL RESULTS TO A 500 SERVER ERROR

Authorization

Authorization

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

Request Body

Field	Type	Required	Description
name	String	Yes	Portfolio employer name (must be unique)
image	Integer	No	ID of the employer image
description	String	No	The description of the employer

Example Requests

🐍 Python

1import requests
2
3# Create a new employer
4response = requests.post('http://www.example.com/api/portfolios/employers/', 
5  json={
6      'name': 'MoeinWeb',
7      'image': 123,
8      'description': 'MoeinWeb is an international company',
9  },
10  headers={'Authorization': 'Token <your_api_key>'}
11)
12print(response.json())

🌐 Curl

1# Create a new employer
2curl -X POST "http://www.example.com/api/portfolios/employers/" \
3-H "Authorization: Token <your_api_key>" \
4-H "Content-Type: application/json" \
5-d '{
6  "name": "MoeinWeb",
7  "image": 123,
8  "description": "MoeinWeb is an international comnpany"
9}'

Response Fields

Field	Type	Description
id	Integer	Unique ID of the employer
name	String	employer name (unique)
image_data	Object	employer image details
description	String	The description of the employer (nullable)
created_at	String (ISO 8601)	Timestamp when employer was created
updated_at	String (ISO 8601)	Timestamp when employer was last updated

Image Data Structure

Field	Type	Description
id	Integer	Unique ID of the image
type	String	File type (e.g., image/jpeg)
name	String	Original file name
size	Integer	File size in bytes
human_readable_size	String	Human readable file size (e.g., 2.5 MB)
f	String	URL to access the image file
width	Integer	Image width in pixels
height	Integer	Image height in pixels
mode	String	Color mode (e.g., RGB, CMYK)
thumbnails	List of thumbnail objects	Imgae thumbnails

Thumbnail Data Structure

Field	Type	Description
id	Integer	Unique ID of the thumbnail (unique)
f	String	URL to access the thumbnail file
size	Integer	File size in bytes (nullable)

Example Response

{
    "id": 4,
    "name": "همکاران سیستم",
    "image_data": {
        "id": 6,
        "type": "image",
        "name": "technology",
        "size": 5123,
        "human_readable_size": "5.00 KB",
        "f": "http://localhost:8000/media/core_media/2025/12/02/technology.png",
        "width": 225,
        "height": 225,
        "mode": "P",
        "thumbnails": [
            {
                "id": 213,
                "f": "http://127.0.0.1:8000/media/core_media/2026/02/02/thumbnails/test2_ecH0zVV_thumbnail_64x64.jpg",
                "size": 64
            },
            {
                "id": 214,
                "f": "http://127.0.0.1:8000/media/core_media/2026/02/02/thumbnails/test2_ecH0zVV_thumbnail_128x128.jpg",
                "size": 128
            },
            {
                "id": 215,
                "f": "http://127.0.0.1:8000/media/core_media/2026/02/02/thumbnails/test2_ecH0zVV_thumbnail_512x512.jpg",
                "size": 512
            },
            {
                "id": 216,
                "f": "http://127.0.0.1:8000/media/core_media/2026/02/02/thumbnails/test2_ecH0zVV_thumbnail_1080x1080.jpg",
                "size": 1080
            }
        ]
    },
    "description": "همکاران سیستم شرکتی در زمینه ... است",
    "created_at": "2026-01-13T09:55:00.750306Z",
    "updated_at": "2026-01-13T09:55:00.750315Z"
}