Prepare a studio-owned bulk athlete team change
Requires an active studio-owned API account with the event_teams:write scope. The server derives the studio from the API key and rechecks event/team ownership in Convex. Prepare returns an opaque, short-lived confirmation bound to the reviewed roster; it does not apply membership changes.
Authorizations
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
Untrusted optional analytics hint naming the calling client surface. It never affects authorization, routing, pricing, or behavior.
1 - 100Untrusted optional analytics hint naming the calling client version. It never affects authorization, routing, pricing, or behavior.
1 - 100Untrusted optional analytics hint naming the invocation mode. It never affects authorization, routing, pricing, or behavior.
1 - 100Body
Response
Authoritative review preview and confirmation binding
Authoritative review projection from Convex. Its contents are event-team domain data and may evolve additively.
When true, confirmationId, confirmationFingerprint, and expiresAt must be sent unchanged to apply.
Opaque fingerprint returned by prepare and required unchanged by apply when requiresConfirmation is true.
1Opaque, short-lived confirmation. It is valid only with its matching fingerprint when requiresConfirmation is true.
1Unix epoch milliseconds when a confirmation expires.
x >= 1