Bookings
Update Booking Status
Generic status update endpoint that accepts both FSM transition names and friendly aliases.
Accepted status values:
| Value | FSM Transition |
|---|---|
cancelled or cancel_booking | Cancel the booking |
no-show or set_noshow | Mark as no-show |
check-in, arrived, or set_arrived_in_service | Check in |
accepted or accept_booking | Accept the booking |
rejected or reject_booking | Reject the booking |
The transition is validated against the booking's current state machine state.
Authorization
bearerAuth AuthorizationBearer <token>
Supports two token types:
- Restaurant tokens — API tokens with
restaurant-apiability, issued per restaurant. - User tokens — Personal access tokens with
mobile-accessability (e.g. for the mobile app). When managing multiple restaurants, includeX-Restaurant-Id: <id>header.
In: header
Path Parameters
booking*string
Booking ID or reference string.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://devrms.tabdevx.com/api/restaurant/bookings/string/status" \ -H "Content-Type: application/json" \ -d '{ "status": "cancelled" }'{
"message": "Booking status updated successfully",
"booking": {
"id": 123,
"reference": "API-ABC123",
"status": "cancelled"
}
}{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z"
}
}{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Booking not found.",
"details": null
},
"meta": {
"timestamp": "2026-03-18T10:00:00Z"
}
}{
"message": "Booking cannot be cancelled in its current status",
"current_status": "cancelled"
}{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z"
}
}