Skip to content
HeadlessWP Pro

Cancel booking

id: fluent-booking-bookings-cancel owner: fluent-booking method: POST path: /wp-json/headlesswp/v1/bookings/{bookingId}/cancel title: Cancel booking usedBySite: false

POST /wp-json/headlesswp/v1/bookings/{bookingId}/cancel

Cancels an existing booking.

Auth + CSRF

  • Auth: public route, but booking-manage authorization is required.
  • Logged-in users are gated by filter headlesswp_pro_fluentbooking_user_can_manage_booking.
  • Logged-out users must send X-HeadlessWP-Bookings-Manage-Token.
  • Proxy nonce required: no.
  • CSRF: exempt (not WP nonce-based).

Request schema

  • Path param: bookingId (required).
  • Header (guest manage flows): X-HeadlessWP-Bookings-Manage-Token.
  • Optional body field: cancelReason.

Response schema

{
  "data": {
    "booking": {}
  }
}

Error codes

  • NOT_AUTHENTICATED (401)
  • VALIDATION_FAILED (422)
  • BOOKING_NOT_FOUND (404)
  • BOOKING_ACTION_NOT_ALLOWED (403)
  • BOOKING_ALREADY_CANCELLED (409)
  • BOOKING_CANCEL_NOT_ALLOWED (409)
  • DEPENDENCY_UNAVAILABLE (503)