Mark a booth away
booth_set_awayIdempotent
Marks a booth the person staffs as stepped away, or back; attendees looking at that booth see the presence change. Needs a personal connector token (a shared token reads but changes nothing), eventId, boothId and away. Only a booth the person owns, administers or staffs at that event can be changed, checked against live records on every call. It works in two steps: a call without confirm returns a preview of exactly what will change, plus a confirmToken, and changes nothing; a call with confirm true and that token makes the change. The token lasts two minutes, works once, and stops working if any argument changes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| away | Yes | true to mark the booth stepped away, false to mark it back. | |
| boothId | Yes | The booth id, exactly as events_booths returned it. Not the booth name. | |
| confirm | No | Absent on the first call, which changes nothing. true, together with confirmToken, makes the change. | |
| eventId | Yes | The event the booth is at, exactly as events_list returned it. | |
| requestId | No | An id for this change chosen by the caller, at least 8 characters. A repeat with the same id and the same arguments returns the first result without changing anything a second time. | |
| confirmToken | No | The token the first call returned. Needed when confirm is true. |