Reservation Schedules

Manage reservation schedules for catalog items. A catalog item must have is_reservation = true before you can create a schedule for it. Use action="upsert" to configure a schedule (requires catalog_item_id, timezone, and days). Use action="list" or action="get" to read schedules.

Input Schema

Parameter	Type	Description
action	string	Action to perform: list, get, upsert, delete
id	string	Schedule UUID (optional for get/delete if catalog_item_id is provided)
catalog_item_id	string	The reservable catalog item UUID (required for upsert)
site_id	string	Seller site UUID (defaults to current site)
duration_minutes	number	Length of a single slot in minutes (default 60)
capacity	number	Maximum seats per slot (default 1)
timezone	string	Timezone for the schedule (e.g. America/Mexico_City)
days	string	JSON string for weekly windows. e.g. `{"monday": {"enabled": true, "start": "09:00", "end": "17:00"}}`
limit	number	Limit results for list
offset	number	Offset results for list

Validation

At least one day in the days object must be enabled: true.
The target catalog_item must have is_reservation = true.
The days object expects lowercase day names (monday, tuesday, etc.).

Example


{
  "action": "upsert",
  "catalog_item_id": "CAT_ITEM_ID",
  "timezone": "America/Mexico_City",
  "duration_minutes": 60,
  "capacity": 10,
  "days": "{\"monday\":{\"enabled\":true,\"start\":\"09:00\",\"end\":\"17:00\"},\"tuesday\":{\"enabled\":false}}"
}