Salla Docs

Attach Image

Production

https://api.salla.dev/admin/v2

POST

/products/{product}/images

Product Images

Last modified:2025-05-11 08:17:12

This endpoint allows you to add up to 10 images to a specific product by passing the product as a path parameter.

Note

You can only send one image per request.

You can attach an image to a product either via URL link or by uploading an image.

Scopes

products.read_write- Products Read & Write

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.salla.dev/admin/v2/products//images' \
--form 'photo=@"@\"Users/Images/profile.png\""' \
--form 'default="1"' \
--form 'sort="1"' \
--form 'alt="Alt Text"'

Response Example

201 - Example

{
    "status": 201,
    "success": true,
    "data": {
        "id": 713368802,
        "image": {
            "original": {
                "url": "https://cdn.salla.sa/bYQEn/9oJoUzXfR8zzXAwAlTRHNIl1xBsuFpgcXdPnkAXd.png",
                "width": 0,
                "height": 0
            },
            "standard_resolution": {
                "url": "https://cdn.salla.sa/bYQEn/9oJoUzXfR8zzXAwAlTRHNIl1xBsuFpgcXdPnkAXd.png",
                "width": 0,
                "height": 0
            },
            "low_resolution": {
                "url": "https://cdn.salla.sa/bYQEn/9oJoUzXfR8zzXAwAlTRHNIl1xBsuFpgcXdPnkAXd.png",
                "width": 0,
                "height": 0
            },
            "thumbnail": {
                "url": "https://cdn.salla.sa/bYQEn/9oJoUzXfR8zzXAwAlTRHNIl1xBsuFpgcXdPnkAXd.png",
                "width": 0,
                "height": 0
            }
        },
        "sort": 5,
        "default": true,
        "alt_seo": "image",
        "video_url": "",
        "type": "image"
    }
}

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

product

integer

required

Unique identification number assigned to a product. List of products IDs can be found here.

Body Params multipart/form-data

photo

file

required

A specific location or directory on a computer's file system that indicates the file's location.

Example:

@"Users/Images/profile.png"

default

integer

optional

Set the image as default

Example:

sort

number

optional

Sorting order of the image

Example:

alt

string

optional

Alternative text to appear when the image doesn't load properly.

Example:

Alt Text

Responses

🟢201Attached Successfully

application/json

Body

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (ProductImagesVideos)

optional

number

required

A unique identifier associated with the product image.

Example:

1908361139

image

object

required

sort

number

required

Sort order

Example:

default

boolean

required

Whether or not the image the default picture

Default:

false

alt_seo

string | null

required

Alternative SEO text for the image

video_url

string

required

Video web address.

type

string

required

Attachment type

Example:

image

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized

Modified at 2025-05-11 08:17:12

Attach Youtube Video

Update Image