Images
Bulk Upload Images
Uploads up to 10 images from base64 encoded strings or URLs. Supports automatic product/variant association via filename matching with SKU or slug. Generates blurhash automatically if not provided. Returns lists of successful and failed uploads with detailed error reasons.
POST
/
api
/
v1
/
{team_slug}
/
{app_slug}
/
images
/
bulk
Error
A valid request URL is required to generate request examples{
"data": {
"failed": [
{
"filename": "<string>",
"reason": "<string>"
}
],
"successful": [
{
"alt": "<string>",
"app_id": "<string>",
"attributes": [
{
"created_at": "<string>",
"description": "<string>",
"filterable": true,
"id": "<string>",
"key": "<string>",
"name": "<string>",
"template_key": "<string>",
"template_name": "<string>",
"translatable": true,
"translations": {
"description": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"name": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
]
},
"updated_at": "<string>",
"values": {}
}
],
"blurhash": "<string>",
"copyright": "<string>",
"custom": {},
"folder_id": "<string>",
"id": "<string>",
"parent_id": "<string>",
"public": true,
"source_app_id": "<string>",
"source_id": "<string>",
"status": "<string>",
"title": "<string>",
"translations": {
"alt": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"copyright": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"title": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
]
},
"url": "<string>",
"used_by": [
{
"created_at": "<string>",
"id": "<string>",
"name": "<string>",
"priority": 123,
"slug": "<string>",
"updated_at": "<string>"
}
],
"variants": [
{
"alt": "<string>",
"app_id": "<string>",
"attributes": "<array>",
"blurhash": "<string>",
"copyright": "<string>",
"custom": {},
"folder_id": "<string>",
"id": "<string>",
"parent_id": "<string>",
"public": true,
"source_app_id": "<string>",
"source_id": "<string>",
"status": "<string>",
"title": "<string>",
"translations": {
"alt": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"copyright": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"title": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
]
},
"url": "<string>"
}
]
}
]
},
"details": [
"<string>"
],
"success": true
}Body
application/json
Images to upload
Maximum array length:
10Show child attributes
Show child attributes
Previous
Bulk Delete ImagesPermanently deletes up to 100 images by their IDs. Removes images from Cloudflare CDN, purges cache, and deletes all associated translations and relationships. Returns lists of successfully deleted and failed deletion attempts with error details.
Next
⌘I
Error
A valid request URL is required to generate request examples{
"data": {
"failed": [
{
"filename": "<string>",
"reason": "<string>"
}
],
"successful": [
{
"alt": "<string>",
"app_id": "<string>",
"attributes": [
{
"created_at": "<string>",
"description": "<string>",
"filterable": true,
"id": "<string>",
"key": "<string>",
"name": "<string>",
"template_key": "<string>",
"template_name": "<string>",
"translatable": true,
"translations": {
"description": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"name": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
]
},
"updated_at": "<string>",
"values": {}
}
],
"blurhash": "<string>",
"copyright": "<string>",
"custom": {},
"folder_id": "<string>",
"id": "<string>",
"parent_id": "<string>",
"public": true,
"source_app_id": "<string>",
"source_id": "<string>",
"status": "<string>",
"title": "<string>",
"translations": {
"alt": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"copyright": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"title": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
]
},
"url": "<string>",
"used_by": [
{
"created_at": "<string>",
"id": "<string>",
"name": "<string>",
"priority": 123,
"slug": "<string>",
"updated_at": "<string>"
}
],
"variants": [
{
"alt": "<string>",
"app_id": "<string>",
"attributes": "<array>",
"blurhash": "<string>",
"copyright": "<string>",
"custom": {},
"folder_id": "<string>",
"id": "<string>",
"parent_id": "<string>",
"public": true,
"source_app_id": "<string>",
"source_id": "<string>",
"status": "<string>",
"title": "<string>",
"translations": {
"alt": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"copyright": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
],
"title": [
{
"id": "<string>",
"locale": "<string>",
"value": "<string>"
}
]
},
"url": "<string>"
}
]
}
]
},
"details": [
"<string>"
],
"success": true
}