Copy one external image into Batch Relay-managed fulfillment storage
Requires print_orders:write and an Idempotency-Key up to 200 characters. Supply exactly one source: an externally routable HTTPS url is downloaded with SSRF protections, content-validated, SHA-256-addressed, and written immutably to the fulfillment R2 scope; an asset_id is resolved as a ready unexpired same-account external asset or a finalized same-studio platform image and is never copied. Source URLs are not fulfillment URLs and are not retained in the managed asset record.
Authorizations
Batch Relay scoped API key, not OAuth. Scope names document required key capabilities.
Headers
Required stable key for the managed ingestion request; reuse with a different URL/source is rejected.
1 - 200Body
- Option 1
- Option 2
Response
Managed immutable asset
Opaque identifier for later managed-asset attachment.
External URL ingress always returns fulfillment; private delivery uses this scope plus object-key lookup.
studio, fulfillment x >= 1image/jpeg, image/png, image/tiff jpeg, png, tiff x >= 1x >= 1^[a-f0-9]{64}$True when the same immutable object already existed or a finalized asset_id was reused.