Upload a product photo
Requires products:update. Creates a new image and appends it by default. Provide exactly one image file or image URL when uploading. Binary files use multipart/form-data; HTTP(S) URLs or base64 image data URIs use application/json. Single uploads complete processing before returning. Maximum 25 MB per image. Image writes update the parent product updatedAt.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
Use the productPhoto JSON wrapper, or bracketed fields such as productPhoto[file] for multipart uploads.
productPhoto
Provide exactly one base64 image data URI or image URL.
Response
Image created.
id
productId
ID of the product that owns the image.
fileUrl
position
createdAt
updatedAt
description
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error