Skip to main content
POST
Prepare a studio-owned bulk athlete team change

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

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
selection
object
required
event_team_id
string

Optional opaque destination team identifier. Omit only when the authoritative selection contract permits it.

Minimum string length: 1

Response

Authoritative review preview and confirmation binding

preview
object
required

Authoritative review projection from Convex. Its contents are event-team domain data and may evolve additively.

requiresConfirmation
boolean
required

When true, confirmationId, confirmationFingerprint, and expiresAt must be sent unchanged to apply.

confirmationFingerprint
string

Opaque fingerprint returned by prepare and required unchanged by apply when requiresConfirmation is true.

Minimum string length: 1
confirmationId
string

Opaque, short-lived confirmation. It is valid only with its matching fingerprint when requiresConfirmation is true.

Minimum string length: 1
expiresAt
integer

Unix epoch milliseconds when a confirmation expires.

Required range: x >= 1