- Artwork becomes a pattern. Make products from it or refine it, like a generated pattern.
- A reference guides a generation or an edit. Pass it to
patterns/createorpatterns/refine/edit.
Files can be JPEG, PNG, WebP or GIF, up to 10 MiB.
1
Get an upload URL
Call
patterns/createUpload with the file’s media type and size in bytes.cURL
2
Send the file
PUT the file to uploadUrl before expiresAt. Send every header in requiredHeaders, exactly as returned.cURL
3
Save the upload
Call The response is the pattern itself, not a job. Among other fields, it includes:Use the
patterns/upload with the uploadId and a new requestId.cURL
patternId in products/create or in a refine.Use a reference
Upload a reference withreferences/createUpload and references/create, then pass its referenceId:
- In
referenceIdsonpatterns/create, to guide a new pattern. - As
referenceIdonpatterns/refine/edit, to guide an edit.
Retries
Saving the sameuploadId again returns the same pattern or reference. It never makes a duplicate. See Idempotency.