Redeem an event code
event_redeem_codeIdempotent
Seats the person at an event with an event code from a badge, a poster, an email or a door. Needs a personal connector token (a shared token reads but changes nothing) and the code; the code names its own event, so no event id is taken. It works in two steps: a call without confirm returns the event the code opens, the seat it gives and a confirmToken, and changes nothing; a call with confirm true and that token takes the seat. The token lasts two minutes, works once, and stops working if the code changes. Redeeming works from anywhere, not only at the venue.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | The code exactly as the person said or read it. Case, spaces and dashes are normalized, so "tie-24" and "TIE24" are the same code. | |
| confirm | No | Absent on the first call, which changes nothing. true, together with confirmToken, makes the change. | |
| requestId | No | An id for this redemption chosen by the caller, at least 8 characters. A repeat with the same id and the same code returns the first result without redeeming a second time. | |
| confirmToken | No | The token the first call returned. Needed when confirm is true. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| seat | No | ||
| error | No | ||
| changed | No | ||
| message | No | ||
| preview | No | ||
| replayed | No | ||
| servedBy | No | ||
| suggestions | No | ||
| confirmToken | No |