Upload product image

POST

https://numueg.app/api/v1/stores/{store_id}/products/{product_id}/images

Last modified:2026-09-19 16:39:33

x-numu-scope:catalog:write

Upload an image for a product.

Accepts JPEG, PNG, WebP, and GIF images.
Maximum file size: 5 MB.

Images are automatically:

Validated and stripped of EXIF metadata

Converted to WebP format with 85% quality

Resized to 3 variants: thumbnail (150px), medium (600px), large (1200px)

Uploaded to Cloudflare R2 storage

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params multipart/form-dataRequired

Responses

🟢201

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//products//images' \
--header 'Authorization: Bearer <token>' \
--form 'file=""'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "content_type": "image/jpeg",
        "key": "products/img-001.jpg",
        "product_id": "550e8400-e29b-41d4-a716-446655440000",
        "size": 204800,
        "url": "https://cdn.numu.com/products/img-001.jpg",
        "variant_urls": {
            "thumbnail": "https://cdn.numu.com/products/img-001_thumb.jpg"
        }
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Delete product

Delete product image