Update a colorway photo (PATCH)
Requires products:update. Replaces the image or edits its metadata; omitted fields are preserved and the parent cannot be changed. 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. Concurrent edits during upload return 409; retry against the current image. Failed uploads preserve the existing image. PUT and PATCH accept the same partial-update fields. Position 0 must be a static image. GIFs are allowed at later positions. Use the numeric variant id, not its uuid. Replacements refresh contentType before validating this rule.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Request
Use the variantPhoto JSON wrapper, or bracketed fields such as variantPhoto[file] for multipart uploads.
Response
Media type of the stored file; refreshed when the file is replaced.