curl --request PATCH \
--url https://api.kelviq.com/api/v1/catalog/products/{product_pk}/image/{pk}/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "primary-hero.png",
"ordering": 1,
"thumbnail": true,
"enabled": true
}
'{
"id": "1f7e1b54-7c6f-4d7e-9a4f-2c9c2d8b9d31",
"name": "hero-banner.png",
"image": "media/.../products/<id>/<uuid>/hero-banner.png",
"ordering": 0,
"thumbnail": true,
"enabled": true
}Update a product image
Updates image metadata such as name, ordering, thumbnail, or enabled. Setting thumbnail to true automatically clears the flag on the product’s other images.
curl --request PATCH \
--url https://api.kelviq.com/api/v1/catalog/products/{product_pk}/image/{pk}/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "primary-hero.png",
"ordering": 1,
"thumbnail": true,
"enabled": true
}
'{
"id": "1f7e1b54-7c6f-4d7e-9a4f-2c9c2d8b9d31",
"name": "hero-banner.png",
"image": "media/.../products/<id>/<uuid>/hero-banner.png",
"ordering": 0,
"thumbnail": true,
"enabled": true
}Documentation Index
Fetch the complete documentation index at: https://docs.kelviq.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'
Path Parameters
Parent product UUID.
Image UUID.
Body
Editable fields on a product image. The underlying file cannot be changed; upload a new image instead.
Response
Updated product image.
An image asset attached to a product.
Unique identifier for the image.
"1f7e1b54-7c6f-4d7e-9a4f-2c9c2d8b9d31"
Original filename or display name.
"hero-banner.png"
Storage key / URL for the image asset.
"media/.../products/<id>/<uuid>/hero-banner.png"
Position of the image in the gallery.
0
If true, this image is used as the product thumbnail.
true
If true, the image is shown publicly.
true