Upload a product sketch
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. List /sketch_groups to find an allowed group. On create, omitting sketchGroupId uses Uncategorized. On update, omission preserves the current group; null or an empty value selects Uncategorized.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
Use the productSketch JSON wrapper, or bracketed fields such as productSketch[photo] for multipart uploads.
productSketch
Provide exactly one base64 image data URI or image URL.
Response
Image created.
id
productId
ID of the product that owns the image.
photoUrl
position
createdAt
updatedAt
description
sketchGroupId
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error