Skip to main content
POST
Reserve a studio-scoped original-asset upload session

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

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

Body

application/json
event_id
string
required
Minimum string length: 1
files
object[]
required
Required array length: 1 - 500 elements

Response

Reconciled session; only reconciled entries with upload_required may be PUT

assets
object[]
required

Only assets whose bytes are still required.

id
string
required

Opaque upload-session binding, not a credential.

reconciled
object[]
required
status
string
required
counts
object