Set a table's status

Frees, reserves or marks a table dirty.

Seating is not done here: a table is occupied while an open order references it, so create the order with a table_id (or move it with PUT /pos/orders/{order_id}). Freeing or reserving a table that still holds an open order returns 409.

Requires a staff token.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
Body Params

Set a table's host-controlled state.

occupied is deliberately not accepted: a table becomes occupied by having
an order attached to it, and the status is derived from that order. Accepting
it here would let a caller set a state the next read would silently discard.

1 to 100
string
enum
required

The table states a client may WRITE.

Occupancy is absent by design — it is derived from the order on the table, so
it can be read back but never set. Mirrors table_service.STORED_STATUSES
and the ck_tables_status CHECK constraint.

Allowed:
Headers
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json