Skip to main content
POST
Create an event image import

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

Path Parameters

studio_id
string
required

Stable public studio ID beginning with stu_. The API never selects a studio implicitly; a local CLI profile name is not a studio ID.

Required string length: 5 - 256
Pattern: ^stu_[A-Za-z0-9_-]+$
event_id
string
required
Required string length: 1 - 256

Body

application/json
manifest
object
required
asset_session_id
string
required
expected_session_revision
integer
required

Asset-session revision returned by the authoritative AssetSession response.

Required range: x >= 1
mapping_csv
string
Maximum string length: 1048576
smart_crop_manifest
object

Required exactly when manifest.kind is smart_crop_masters_preview; forbidden for staged. Its camelCase fields are the frozen Xcode Smart Crop V2 document.

Response

Image import

duplicates
string[]
required
id
string
required
missing_files
string[]
required
proposed_bindings
object[]
required
resolution_diagnostics
object[]
required
revision
integer
required
Required range: x >= 1
status
string
required
unresolved
string[]
required