Karma Common API
string · uuid · requiredboolean · requiredstring · enum · required
number · requiredstring · date · requiredbooleanstring · enum · required
AI-powered booking table optimization
Toggle booking resource lock
PATCH
https://common-api.karma.life
/api/v1/bookings/{id}/lock
Lock or unlock a booking to its assigned table. Locked bookings will not be moved by the optimizer.
Permissions: ⚪ bookings.manage
path Parameters
idBooking ID
Toggle booking resource lock › Request Body
lockedWhether to lock (true) or unlock (false) the booking
Toggle booking resource lock › Responses
Default Response
statusEnum values:
success
object · required
object · required
Optimize booking table assignments
POST
https://common-api.karma.life
/api/v1/locations/{locationId}/bookings/optimize
Run the booking optimization algorithm to improve table utilization. Use dryRun=true to preview changes without applying them.
Permissions: ⚪ bookings.manage
path Parameters
locationIdLocation ID
query Parameters
dateDate to optimize (YYYY-MM-DD)
Optimize booking table assignments › Request Body
dryRunIf true, only preview changes without applying them
Default: true
Optimize booking table assignments › Responses
Default Response
statusEnum values:
success
object · required
object · required