OmceanBooking

Cancel one existing class reservation using its exact customer_attendance_id from get_customer_class_history or list_session_attendees. May send the normal cancellation notification. This does not cancel the class session, create a replacement booking or mark roll-call attendance. To move a reservation, obtain approval for both this cancellation and create_class_reservation; preserve customer/dependent identity and report any partial failure.

cancel_class_reservation

Assign or clear the dependent on one existing active booking without cancelling or replacing that booking. Resolve the exact booking and dependent first; null clears the dependent only when requested. The dependent must belong to the booking customer. Preserves the pass, payment and reservation state and sends no cancellation notification.

update_booking_dependency

ADMIN-ONLY add ONE named entry to the customer-chatbot Knowledge LIST. This is background reference, distinct from authoritative Q&A. The name/text are screened server-side for attempts to reprogram the assistant. Requires approval of the requested change.

create_ai_chatbot_knowledge

ADMIN-ONLY add one authoritative customer-chatbot Q&A training pair. The question and answer are screened server-side for attempts to reprogram the assistant. Requires approval of the requested change.

create_ai_chatbot_qa

ADMIN-ONLY: create one appointment add-on ITEM. Requires an English or Chinese name; defaults are price 0, duration 0 extra minutes, scope booking, Standalone. A Standalone item is offered on the services in class_ids (appointment services from list_classes); a Part of Group item (appointment_addon_in_group=true) takes no class_ids and is offered through a group (create_appointment_addon_group / update_appointment_addon_group). Read list_appointment_addons first to avoid duplicating an existing item. For a second SERVICE booked alongside a main one use set_appointment_addon_class instead.

create_appointment_addon

ADMIN-ONLY: create one add-on GROUP: name, selection rule (single = customer must pick exactly one, single_optional = one or none, multiple = any combination), scope (booking or per_person), the services it is offered on (class_ids) and its members in display order (appointment_addon_ids — each must already be a Part of Group item). Read list_appointment_addons first.

create_appointment_addon_group

Create a new class type. Requires an existing location_id (list_locations first). reservation_type decides how customers pay: "pass" (pass only), "one-off" (drop-in price), or "both". Link passes either here via accepted_pass_ids or later from the pass side via create_pass accepted_class_ids — once, not both.

create_class

Create a class CATEGORY (name + optional calendar colour "#RRGGBB"), optionally putting classes into it right away (class_ids). Categories help customers filter classes and colour-code the schedule.

create_class_category

Create a class ROOM (a physical space, e.g. "Studio A"): name, location (list_locations), capacity, optional description. After creating, assign it as a class's default room (update_class class_room_id) or to individual sessions (set_session_room).

create_class_room

Create one named, fixed-length course and all its dated sessions in one operation. Requires an existing class, session_dates and shared start_time; optional instructor/capacity apply as specified. Use for a multi-session program booked as a course, not an open-ended weekly repetition. Obtain missing values before approval. Do not create its sessions again separately; retrying can duplicate the course.

create_course

Add one dependent to an identified existing customer account after checking list_customer_dependencies for feature availability and an exact duplicate. Requires the account owner ID and the dependent name supplied by the user; obtain either if missing. Optional birthday and notes belong to the dependent. Does not create a booking or edit a profile picture. Requires write approval; retrying a successful creation can create a duplicate.

create_customer_dependency

Create an equipment item and optional physical units. An English or Chinese name is required. Defaults are capacity 1, exclusive assignment, standalone, hidden unit names, optional, zero price, and one active unit. Create grouped items with equipment_in_group=true, then add them to a group with create_equipment_group or update_equipment_group. Class assignment is a separate set_class_equipment step.

create_equipment

Create an equipment group, optionally with ordered grouped-equipment members. equipment_group_allocation=automatic allocates equipment for the customer; customer_choice lets them choose. equipment_group_allocation_mode=sequential fills in priority order, balanced spreads use, and optimized currently starts with sequential allocation and forces equipment_group_keep_together to preferred. Never promise a later automatic reassignment.

create_equipment_group

Create an intake form, cancellation form, survey, or post-class feedback form from existing item IDs, including INFO_BOX, PARAGRAPH and ADD_DEPENDENT. Optional intake_form_conditions sets per-item visibility/required rules. Choose a different simple question in this form as the source; no self references, cycles, dependent/content sources or compound AND/OR groups. SELECT conditions compare the numeric option_id, not its label. Content items allow visibility only. BEFORE creating any form or question for it, ALWAYS call list_intake_forms to verify the feature and rule out a duplicate, then list_intake_items to reuse equivalent questions. If either prerequisite read returns an error, STOP and ask the user to retry; never treat an unreadable library as empty, create replacement questions from scratch, or try get_intake_form as a workaround. If the requested outcome does not make the type clear, ask whether this is an intake form (during class booking/pass purchase), cancellation form (before cancelling a class reservation), feedback form (after an attended class), or survey (sent to a customer audience) before writing. Intake, cancellation and feedback forms become active when created; surveys remain drafts until publish_survey. Intake forms must target a class or pass; cancellation forms may target selected classes or all classes when class_ids is empty and never target passes; feedback forms target classes only; surveys target customers/roles/tags only. A required cancellation form blocks cancellation until submitted, while an optional form may be skipped. This never submits answers for a customer.

create_intake_form

Create one reusable question or content/dependent item for an intake form, survey or feedback form. INFO_BOX is a callout with optional emoji (default none); PARAGRAPH is plain text. Both require message_en or message_cn using the canonical field names, allow both languages, and cannot be required or have default answers. ADD_DEPENDENT embeds the customer dependent form; this action creates only the reusable item, never a customer dependent. This backend action is page-independent: create it directly from Content or any other admin tab and never navigate to Form Items first. SELECT questions require choices. Question type is permanent after creation, so verify it carefully. Creating a question does not attach it to a form.

create_intake_item

Create one business location or branch. Requires a name; other fields are optional. Omit business_hours to leave opening hours unconfigured. Use list_locations to check for an existing matching branch before creating another. The new location can be referenced by classes and passes.

create_location

Create a new pass. type "classes" needs number_of_visits (e.g. 10-class pack), "membership" is unlimited visits within duration_days, "points" uses a point balance. Defaults to sold in-person only — set purchase_online=true to let customers buy it themselves.

create_pass

Create one discount, coupon or referral campaign while Discounts is enabled. Requires the requested eligibility and value; resolve any ambiguous customer/role/tag audience before calling. Coupon codes are normalized, checked for duplicates and then immutable; percentage values are 1–99 and giveaways are coupon-only. Referrals require two independently specified values: the new-customer discount and referrer reward. Creation affects eligibility for future purchases and requires approval.

create_promotion

Create one weekly or fortnightly repeating class definition from a start date and one or more time_slots. Requires the existing class and requested slots; generated calendar sessions are created automatically. Use for an ongoing repetition, not a single occurrence or a fixed-length course. Obtain missing values before approval. Retrying a successful creation can duplicate the repetition.

create_recurring_class

Create one class calendar occurrence on a specified date and time in the business timezone. Requires an existing class_id; duration determines the end time. Optional instructor, capacity and course association apply to this occurrence. Use for a one-off class; recurring schedules and fixed-length courses have separate tools. Obtain missing required values before approval. Retrying a successful creation can create a duplicate.

create_schedule_session

ADMIN-ONLY create one Shop category beneath an exact active shop_category_parent_category_id. Use a supplied exact ID, or resolve the parent with list_shop_categories when the user gives a name. PHP independently verifies that the parent exists and is active. This is a discrete insert and does not replace or reorder the category tree. Provide at least one localized name.

create_shop_category

ADMIN-ONLY create a simple Shop product with one non-variant purchasable item. The Shop feature must already be enabled. After creation, use set_shop_product_variant_matrix for variants and set_shop_product_addons for class/pass add-on links. Media remains page-led.

create_shop_product

Create a tag with English/Chinese name and public visibility. Relationship assignment is separate so creating a tag cannot replace existing links.

create_tag

Book one explicitly identified customer or dependent into an existing class session. Resolve the customer with find_customers and the session with list_schedule. For a dependent, include the exact customer_dependency_id. A specified pass_purchased_id must belong to the customer and be eligible; otherwise omit it so the platform chooses an eligible pass or records No pass/unpaid. May send the normal booking notification. Repeating this call can create duplicate bookings. This does not create a class session, cancel a booking or mark roll-call attendance.

create_class_reservation

Soft-delete one exact class-schedule announcement. PHP verifies both custom_feature_blog_id and class_schedule_id plus selected-location scope. Existing delivered notifications are not recalled.

delete_class_schedule_announcement

Soft-delete one ordinary Blog, News, or global Announcement after resolving and showing its exact custom_feature_blog_id. This removes it from the normal content surface. Schedule-bound announcements use delete_class_schedule_announcement.

delete_content_post

Inspect bookable appointment times and diagnose availability for one service and date, optionally one time/practitioner. Returns duration, interval, buffers, service/practitioner hours, closures, generated time candidates, available slots, issues and permitted recent changes. Generated candidates are not necessarily available slots. Slot start/end and reserved windows explain buffers. A stale-generation flag or explicit issue is evidence; missing times alone do not prove a cause. Does not create appointments or inspect a customer browser. Pre-date service/instructor choice issues use diagnose_appointment_selection.

diagnose_appointment_availability

READ-ONLY saved appointment service/instructor selection diagnosis BEFORE a date is chosen. Use for missing services, missing instructor choices, or inability to continue from the instructor step. Resolve the exact service first. When comparing a working and affected service, call this tool for EACH class_id before stating their settings differ. Returns saved service visibility, instructor-choice/no-instructor-required flags, business No preference and step settings, and all active instructor connections including ineligible people. A connection alone is insufficient: customer picker excludes deleted/archived people, removed Instructor roles, closed instructor appointment switches, and mismatched customer-selected locations. One eligible linked instructor should still appear when preference is allowed; only one CLASS showing instructors does not mean only one INSTRUCTOR exists. False instructor preference hides named choices intentionally; it does not mean no teacher is assigned. The business hide-all-instructors setting actually hides No preference, not named teachers. Updated customer UI keeps automatic assignment available when the class disallows choice, overriding that business setting. If both options are absent and the customer cannot continue, do not call that normal: the screen contradicts expected behavior and needs UI/version investigation. These are saved values; page form fields may be unsaved. This tool does not inspect the customer browser, prove which UI version is deployed, check booking quotas, or calculate date-specific availability. Never blame hours, daily limits, or existing bookings for a missing pre-date instructor list. For missing time slots AFTER selecting a date, use diagnose_appointment_availability instead. Explain findings in the owner’s language, without raw field names. Do not change settings just to diagnose.

diagnose_appointment_selection

ADMIN-ONLY evidence diagnostic for why one customer is or is not being asked for the business waiver. Checks feature enabled, live/content state, latest version, and that customer’s current acceptance pointer. Lead with the first issue. Does not expose signatures or alter/revoke acceptance.

diagnose_business_waiver

Read the effective future sessions and sold-out risks for one class-package pass. Use an exact pass_id for package eligibility questions. Validates the feature and pass without changing them. Creating or editing class packages is not exposed through this connector.

diagnose_class_package

ADMIN-ONLY, READ-ONLY coupon/referral-code debugger. Use for “why did this code fail?”. It checks feature state, normalized code lookup, deleted/archived/date/usage-limit state, and—when customer_id is supplied—customer scope, new-customer/one-use/active-pass rules and self-referral. Pass one pass_id or shop_item_group_id to also verify item applicability. eligible=null means required customer or item context was omitted; state exactly what was not checked. This never changes a cart.

diagnose_coupon

READ-ONLY Gate debugger for why one customer is currently allowed or denied at a location. Evaluates business hours, explicit deny/allow, allow-all, reservation and active-pass rules using the same access engine as the gate. This evaluates now; use access history for a past event.

diagnose_gate_access

ADMIN-ONLY, READ-ONLY evidence diagnostic for “why did/didn’t this customer see an intake, cancellation, survey, or feedback request?”. Checks feature/form state, assignments, targeting, response state, expiry, feedback attendance/timing facts, and cancellation reservation/class eligibility. Cancellation forms appear inline before the reservation is cancelled and never create pending to-dos. The FIRST sentence after this tool returns MUST state issues[0] verbatim when issues is non-empty; do not summarize form/customer metadata before the blocker. Then add only useful facts. Never invent a motive or claim a notification was sent.

diagnose_intake_delivery

ADMIN-ONLY read-only debugger for why a pass purchase, shop purchase, or class attendance did or did not earn loyalty rewards. Checks the feature, live setting, effective default/override, attendance/payment-linked reward state, and computes the expected amount when price is supplied for percentage purchase rewards.

diagnose_loyalty_reward

ADMIN-ONLY read-only pass rollover debugger. Given the newly purchased destination pass and optionally an expected source pass, evaluates the same major gates as automatic rollover: feature/mode, customer and pass type/template, membership/subscription exclusion, destination verification, source activation/expiration threshold, payment verification, and remaining visits.

diagnose_pass_rollover

ADMIN-ONLY evidence diagnostic for why a pass template or purchased pass does/does not require a waiver. Checks feature/global live state, the one effective pass assignment, purchased-pass currentness/expiry/cancellation, and optionally customer ownership. Lead with the first issue; never alter or forge acceptance.

diagnose_pass_waiver

Diagnose one exact pause with affected passes, estimated original expiries, upcoming reservation counts, and exact global-booking consequences. When the message contains a pause_id, call this tool immediately with that ID—do not list pauses, read generic settings, custom features, or activity logs first. Call before reversing/ending a pause.

diagnose_pause_account

ADMIN-ONLY explain the effective commission mode/configuration and stored attribution for one sold pass or shop item. When the request already supplies an exact pass_purchased_id or shop_item_quantity_id, call this tool immediately with that ID; do not detour through salesperson settings, custom-feature lists, customer/staff search, or inventory lists.

diagnose_sales_commission

ADMIN-ONLY read-only Shop order debugger by payment ID or reference. Explains the exact payment status, deletion, inventory verification, and pickup state without exposing bank/payment secrets.

diagnose_shop_order

ADMIN-ONLY read-only recurring-payment debugger for the initial pass_purchased_id returned by list_customer_subscriptions (a renewal pass ID is also resolved safely). Checks subscription status/failure count and the exact payment/deletion state of the initial and every renewal payment. When the owner asks about charges or payment history, present EVERY returned payment with its amount and payment_status_enum; never collapse the rows to only a count or latest payment. It does not expose provider response payloads or secrets and cannot prove the bank/card decline reason when the provider did not store one.

diagnose_subscription