AKTIO

Book an appointment at a salon. Before calling, show the user the salon, services, staff member, date and time, and the name and phone number the booking will be made under, and get their explicit confirmation. Take datetime from check_availability. The salon receives the name, phone number and optional email and comment, and may contact the client about the appointment. Not safe to repeat blindly: a second call for the same time fails because the time is taken, and a call for another time creates a second booking. Returns record_id and record_hash; give both to the user, because rescheduling or cancelling requires them.

create_booking

Cancel an existing booking. Requires the record_id and record_hash that create_booking returned. Confirm with the user before calling: cancelling releases the time, the salon is notified, and it cannot be undone — a new booking would be needed.

cancel_booking

Find free booking times at one salon. Without date it returns the dates that still have free time, optionally for one staff member and set of services. With date and staff_id it returns the free start times on that date, each with the exact datetime that create_booking and reschedule_booking expect. Pass service_ids whenever the user has chosen services: without them the times assume the shortest service, and a longer one may not fit. Read-only: it does not hold or reserve a time.

check_availability

List the services that can be booked at one salon (haircuts, beard trims, treatments and so on), with each service id, title, category, price range in the salon's local currency and duration in seconds. Pass staff_id to list only what that staff member provides. Use it to answer questions about services and prices, and to get the service ids that booking needs. Read-only.

search_services

List the staff members (barbers, stylists and so on) who take online bookings at one salon, with each staff id, name, specialization, rating, number of reviews, photo URL and the last date their schedule is open for booking. Pass service_ids to list only staff who provide those services. Use it when the user wants to choose a specific person, and to get the staff_id that availability and booking need. Read-only.

get_staff

List the salons and barbershops that can be booked through Aktio, with their location_id, name, city, address, category and opening hours. Use it when the user wants to book or browse and has not picked a salon yet; the other Aktio tools take the location_id it returns. Only salons that have connected Aktio are listed, so a salon missing here cannot be booked through Aktio. Read-only.

search_salons

Move an existing booking to a new start time with the same staff member and services. Requires the record_id and record_hash that create_booking returned. Find the new time with check_availability first, and confirm the change with the user before calling: the original time is released and may be taken by someone else, so the move cannot be reliably undone. To change the staff member or services, cancel and book again.

reschedule_booking