Change the vehicle class of a reservation

Changes the booked vehicle class of an existing reservation and reprices it.

Requires the role permission Can edit Reservations (Step 1 to 5), and the reservation must be in quote, open, pending or pending-reserved status. Otherwise a business error is returned.

Side effects

The rates saved when the reservation was booked are discarded. When vehicle_class_id is a different class (not the booked class nor the current free upgrade), the free upgrade is removed.

The assigned vehicle is detached (and a vehicle is assigned automatically when your account assigns vehicles with availability per location).

To keep the price and only give a better vehicle, use POST /car-rental/reservations/{reservation_id}/free-vehicle-class-upgrades instead. To change the class together with other booking details, use POST /car-rental/reservations/{reservation_id}/update.

An unknown numeric reservation_id does not return 404. An unknown UUID returns 404.

Responses

🟢200OK

application/json

The repriced reservation overview, or a business error. HTTP 200 is also used for failures: always check success. When it is false, the body is an ErrorBusinessRule (status_code 410) or an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Examples

Class not availableReservation cannot be updated

{
    "success": false,
    "status_code": 410,
    "errors": {
        "vehicle_class_id": [
            "The selected vehicle class is not available anymore"
        ],
        "error_message": "The selected vehicle class is not available anymore"
    },
    "data": []
}

🟠404Record Not Found

🟠422Parameter Error

Change the vehicle class of a reservation

Request

Responses