public
Reserve Handle
One-shot: turns a pending signup into a live Tandem user.
Wraps three steps in a single transaction so an error anywhere rolls everything back:
1. UPDATE the reservation row (used_at, handle_issued). A
concurrent request that beat us loses the race — 0 rows
affected = 410 Gone.
2. INSERT into handles. Unique violation = 409 Conflict (handle
was just claimed in a different /reserve call).
3. INSERT into tokens bound to the new handle.
Returns { handle, token, email } with the raw bearer token. Token is never shown again.
post/v1/handles/reserve
Request
- Base URL: https://www.tandem-cc.com (the document declares no server; this is the origin it was published from)
- URL: https://www.tandem-cc.com/v1/handles/reserve
- Auth: none declared
Request body
object required
Response
Successful Response
object required
Changes
No recorded changes to this operation across all 1 revision of this API.