Update Portfolio Link

Updates an existing portfolio link with new information. Only the provided fields will be updated.

HTTP Request

PATCH/api/portfolios/:portfolio_id/links/:id

Authorization

Authorization

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

Path Parameters

Parameter	Type	Required	Description
portfolio_id	Integer	Yes	Unique ID of the related portfolio
id	Integer	Yes	Unique ID of the link to update

Request Body

Field	Type	Required	Description
name	String	No	link name (no need to be unique)
image	Integer	No	ID of the link image
url	URLField	No	Url related to the link
description	String	No	Description of the link

Example Requests

🐍 Python

1import requests
2
3# Update link name and image 
4response = requests.patch('http://www.example.com/api/portfolios/2/links/123', 
5  json={
6      'name': 'طراحی سایت وردپرسی',
7      'image': 123
8  },
9  headers={'Authorization': 'Token <your_api_key>'}
10)
11print(response.json())
12
13# Update only the image
14response = requests.patch('http://www.example.com/api/portfolios/2/links/123', 
15  json={
16      'image': 456
17  },
18  headers={'Authorization': 'Token <your_api_key>'}
19)
20print(response.json())
21
22# Remove image by setting to null
23response = requests.patch('http://www.example.com/api/portfolios/2/links/123', 
24  json={
25      'image': None
26  },
27  headers={'Authorization': 'Token <your_api_key>'}
28)
29print(response.json())

🌐 Curl

1# Update link name and image
2curl -X PATCH "http://www.example.com/api/portfolios/2/links/123" \
3-H "Authorization: Token <your_api_key>" \
4-H "Content-Type: application/json" \
5-d '{
6  "name": "طراحی سایت وردپرسی شماره ۱",
7  "image": 2
8}'
9
10# Update only the image
11curl -X PATCH "http://www.example.com/api/portfolios/2/links/123" \
12-H "Authorization: Token <your_api_key>" \
13-H "Content-Type: application/json" \
14-d '{
15  "image": 456
16}'
17
18# Remove image by setting to null
19curl -X PATCH "http://www.example.com/api/portfolios/2/links/123" \
20-H "Authorization: Token <your_api_key>" \
21-H "Content-Type: application/json" \
22-d '{
23  "image": null
24}'

Response Fields

Field	Type	Description
id	Integer	Unique ID of the link
name	String	link name (not unique)
image_data	Object	link image details
description	String	Description of the link (nullable)
url	URLField	Url related to the link (nullable)
created_at	String (ISO 8601)	Timestamp when link was created
updated_at	String (ISO 8601)	Timestamp when link 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": "دمو پروژه",
    "url": "https://moeinsoft.com/demo",
    "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-13T10:05:43.296270Z",
    "updated_at": "2026-01-13T10:05:43.296310Z"
}