Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Upload Image

POST

https://api.zid.sa/v1/products/{product_id}/images/

Use this endpoint to add a single image to a product.

🔑Scopes

products.read_write - Products Read & Write

Request

Path Params

Header Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/products/96d0f5c3-1958-4a31-8b03-7014c2070630/images/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Store-Id: {{StoreId}}' \
--header 'Accept-Language: en' \
--form 'image=@"cmMtdXBsb2FkLTE3NzExNjEzNzY5MTQtMg==/test1.jpg"' \
--form 'alt_text="test alt text"'

Responses

🟢200OK

application/json

Body

Example

{
    "id": "59b5fff2-2281-44a4-8bf1-56d9fd1165bb",
    "image": {
        "full_size": "https://media.zid.store/d297fb8b-c322-412e-a2f4-ffa96dc57022/59b5fff2-2281-44a4-8bf1-56d9fd1165bb.jpg",
        "medium": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/59b5fff2-2281-44a4-8bf1-56d9fd1165bb-thumbnail-770x770-70.jpg",
        "large": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/59b5fff2-2281-44a4-8bf1-56d9fd1165bb-thumbnail-1000x1000-70.jpg",
        "small": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/59b5fff2-2281-44a4-8bf1-56d9fd1165bb-thumbnail-500x500-70.jpg",
        "thumbnail": "https://media.zid.store/thumbs/d297fb8b-c322-412e-a2f4-ffa96dc57022/59b5fff2-2281-44a4-8bf1-56d9fd1165bb-thumbnail-370x370-70.jpg"
    },
    "alt_text": "test alt text",
    "display_order": 2
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-02-16 06:18:27

List Images

Update Image Order