Skip to main content
POST
Import a public HTTPS image into owned managed artwork

Authorizations

Authorization
string
header
required

Dedicated expiring guest-session capability. Never a developer API key. No Batch Relay account or Studio membership required.

Headers

Idempotency-Key
string
required
Required string length: 1 - 200
X-BatchRelay-Client-Surface
string

Untrusted optional analytics hint naming the calling client surface. It never affects authorization, routing, pricing, or behavior.

Required string length: 1 - 100
X-BatchRelay-Client-Version
string

Untrusted optional analytics hint naming the calling client version. It never affects authorization, routing, pricing, or behavior.

Required string length: 1 - 100
X-BatchRelay-Invocation-Mode
string

Untrusted optional analytics hint naming the invocation mode. It never affects authorization, routing, pricing, or behavior.

Required string length: 1 - 100

Path Parameters

session_id
string
required
Maximum string length: 100

Body

application/json
url
string<uri>
required
Maximum string length: 4096
original_filename
string
Maximum string length: 255

Response

Success

asset_id
string
required
content_type
string
required
pixel_height
integer
required
Required range: 1 <= x <= 25000000
pixel_width
integer
required
Required range: 1 <= x <= 25000000