Skip to main content
POST
Exchange a single-use handoff and rotate the session token

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
handoff_code
string
required
Pattern: ^brh_[A-Za-z0-9_-]{43}$

Response

Success

assets
object[]
required
expires_at
string<date-time>
required
handed_off
boolean
required
items
object[]
required
mode
string
required
session_id
string
required
session_token
string
required
status
string
required