Scheduling

Appointment availability and booking management

EndpointsCopy Anchor Link

• DELETE Cancel a booking — Cancels a confirmed booking, releases its slot, and clears any reminder claim. Visitor bearer callers may cancel only bookings linked to their own conversation.
• POST Create a booking — Creates a booking in confirmed status. A booking may later become cancelled, completed, or no_show.
• GET Get available time slots for a date — Returns future 30-minute slots for the requested date, from 09:00 through 16:30 in the selected timezone. date must use YYYY-MM-DD.
• GET List bookings for a conversation — Returns every booking linked to the required conversationId, including confirmed, cancelled, completed, and no_show bookings. The response is not paginated.
• GET List confirmed bookings for a specific date — Returns confirmed bookings for the required date, ordered by local timeSlot. The date must use YYYY-MM-DD.
• POST Reschedule a booking to a new slot — Moves a confirmed booking to a new future 30-minute slot without changing its ID or conversation link.
• POST Set booking outcome (completed / no-show) — Records the final outcome of a confirmed booking. The request body accepts only completed or no_show; bookings already in a terminal state return 422.