Photos
Upload source images and submit requested replacement images.
Upload photos
Uploads one or more image files and returns one result per file in the
same order. Send every part under the repeated field name photos.
HTTP 200 indicates that the batch was processed, not that every file
uploaded. Check each result's status. An uploaded result contains a
managed url that must be used in order or update-photo requests; a
failed result contains an error and no url. Validation happens
before upload, so an invalid file rejects the complete request rather
than producing an individual failed result.
Supported image formats are JPEG, PNG, HEIC, HEIF, WebP, and AVIF. Send at most 10 files per request. Each file can be up to 100 MiB and must not exceed 8,000 pixels in either dimension or 50 megapixels.
Upload photos › Request Body
photosUpload photos › Responses
One upload result per submitted file, including per-file failures.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · status="uploaded" · requires: url, original_name | |
| type = object · status="failed" · requires: original_name, error |
statusThe file uploaded successfully.
url^https://media\.legi… · requiredManaged URL to use unchanged in a subsequent order request.
original_nameFilename supplied for the multipart part.
Submit requested photos
Resolves the current photos_to_resubmit request for an order selected
by LegitGrails UUID or external_id.
Every requested index_code must appear. For each entry, supply exactly
one of url or is_unable_to_provide: true. Multiple URL entries may
use the same index up to its max_photos; an unable-to-provide entry
must be the sole entry for its index. Every URL must be a managed URL
returned by POST /photos; other URLs are rejected.
Acceptance is reported with HTTP 202 and status: accepted.
path Parameters
idLegitGrails order UUID or an external_id supplied when creating the order.
Submit requested photos › Request Body
Entries resolving every requested index. Repeated URL entries for
one index are allowed up to its max_photos.
noteOptional note about the submitted photos.
Submit requested photos › Responses
The complete photo-update response was accepted.
idstatus