Skip to navigation

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.

productSketchobjectRequired
Provide exactly one base64 image data URI or image URL.

Response

Image created.
idstringOptionalformat: "uuid"
productIdstringOptionalformat: "uuid"
ID of the product that owns the image.
photoUrlstring or nullOptionalformat: "uri"
positionintegerOptional
createdAtdatetimeOptional
updatedAtdatetimeOptional
descriptionstring or nullOptional
sketchGroupIdstring or nullOptionalformat: "uuid"

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error