Reservations

Manage capacity reservations and find available slots for reservable items. Note that normal checkout flows typically create pending reservations automatically when a user buys a slot. This tool allows for querying inventory or creating admin bookings.

Use action="get_available_slots" to query inventory for a date range (requires catalog_item_id, from_date, to_date). Use action="create" for manual admin bookings (requires catalog_item_id, lead_id, start_time, end_time, and quantity). Use action="update" to change a reservation status (e.g. to cancelled).

Input Schema

Parameter	Type	Description
action	string	Action to perform: list, get, get_available_slots, create, update
id	string	Reservation UUID (required for get, update)
site_id	string	Seller site UUID (defaults to current site)
catalog_item_id	string	Catalog item UUID (required for create, get_available_slots)
lead_id	string	Lead UUID attached to the reservation (required for create)
from_date	string	Start date for slot query (ISO string, e.g. 2026-07-27)
to_date	string	End date for slot query (ISO string)
start_time	string	Start time of the reservation (ISO datetime string)
end_time	string	End time of the reservation (ISO datetime string)
quantity	number	Number of seats/capacity to reserve (default 1)
status	string	Status (e.g. pending, confirmed, cancelled)
limit	number	Limit results for list
offset	number	Offset results for list

Validation

get_available_slots checks the reservation_schedules for the target catalog item and calculates available capacity by subtracting overlapping pending and confirmed reservations.
create will use the availability engine to assert the slot is valid before inserting.
Cancelling a reservation (via update status=cancelled) will free up capacity in the slots.

Example


{
  "action": "get_available_slots",
  "catalog_item_id": "CAT_ITEM_ID",
  "from_date": "2026-07-27",
  "to_date": "2026-07-31",
  "quantity": 2
}