Skip to main content
PUT
Upload bytes for one reserved studio asset

Authorizations

Authorization
string
header
required

Batch Relay scoped API key or an anonymous Test Mode session. Scope names document required capabilities. Anonymous sessions are sandbox-only and do not authorize studio, event, billing, or Live Mode operations.

Headers

Content-Type
enum<string>
required
Available options:
image/jpeg,
image/png,
image/tiff
Content-Length
integer
required
Required range: 1 <= x <= 99614720
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
Minimum string length: 1
asset_id
string
required
Minimum string length: 1

Body

The body is of type file.

Response

Finalized asset lifecycle projection

byte_size
integer
required
Required range: x >= 1
content_type
enum<string>
required
Available options:
image/jpeg,
image/png,
image/tiff
id
string
required

Opaque session-bound image asset ID; it is not a credential.

original_filename
string
required
status
enum<string>
required
Available options:
reserved,
uploading,
uploaded,
ready,
failed,
deleted,
cleanup_leased
upload_session_id
string
required