Cancels a reservation intent. Only reservations with a pending
or confirmed
status may be cancelled. Depending on the cancellation policy, a fee may still apply or the reservation may be non-refundable.
ID of the reservation to cancel.
Returns the Reservation object with status updated to cancelled. If the reservation is no longer cancelable (e.g., already confirmed and within a non-refundable window), an error is returned.