Salla Docs

Attach Image by SKU

Production

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

POST

/products/sku/{sku}/images

Product Images

Last modified:2025-01-20 07:25:03

This endpoint allows you to attach an image by passing the sku as a path parameter.

Note

Make sure that you upload a file of image format by sending the body data as multipart/form-data

Scopes

products.read_write- Products Read & Write

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.salla.dev/admin/v2/products/sku//images' \
--form 'photo="@/home/user/Pictures/sku-image.png"'

Response Example

200 - Example

{
    "status": 201,
    "success": true,
    "data": {
        "id": 1908361139,
        "image": {
            "original": {
                "url": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
                "width": 0,
                "height": 0
            },
            "standard_resolution": {
                "url": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
                "width": 1000,
                "height": 424.597364568082
            },
            "low_resolution": {
                "url": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
                "width": 500,
                "height": 212.298682284041
            },
            "thumbnail": {
                "url": "https://i.ibb.co/jyqRQfQ/avatar-male.webp",
                "width": 120,
                "height": 50.95168374816984
            }
        },
        "sort": 0,
        "default": false,
        "alt_seo": "Product details",
        "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

sku

string

required

The Product SKU. List of Product SKU can be found here.

Body Params multipart/form-data

photo

string

optional

Upload an image as file

Example:

@/home/user/Pictures/sku-image.png

Responses

🟢200Success

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-01-20 07:25:03

Product Images

Attach Video by SKU