Change a booking
change_bookingChanges a ride request at the customer's request (date, time, address, pickup, drop-off, passengers, luggage, car, payment choice, flight, notes). First call get_quote with the complete changed ride and get the customer's approval of the new price, then send the same ride fields with that quoteToken plus the bookingId and the customer's email. A request still waiting for the email confirmation is re-sent with a new link; a request Feminiq Rides has not confirmed yet is updated at once; a confirmed but unpaid request is withdrawn and requested anew: the customer must click the NEW Confirm link emailed to them within 24 hours, otherwise the ride is lost (she then confirms again and sends a new payment request). Needs a fresh quoteToken from get_quote for the changed ride; the quoteToken of the original request cannot be reused. Paid bookings are passed to Feminiq Rides as a change request, which she confirms by email. The ride type (transfer, ride on request, tour) cannot change: cancel and request anew instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"bookingId": "<bookingId>",
"email": "<email>",
"quoteToken": "<quoteToken>",
"type": "<type>",
"car": "<car>",
"date": "<date>",
"time": "<time>",
"passengers": "<passengers>"
},
"name": "change_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| car | Yes | BMW 5 Series Touring (bmw5) max 4 passengers, Mercedes V-Class (vclass) max 7 passengers. | |
| date | Yes | Local date in Europe/Amsterdam. | |
| lang | No | Language of the emails the customer receives (the Confirm link, status and payment mails) and of the quote card. Use the customer's own language; default en. | |
| time | Yes | Local time in Europe/Amsterdam, between 04:00 and 20:00. | |
| type | Yes | ||
| Yes | The customer's email address used for the booking (proves it is their booking). | ||
| notes | No | ||
| flight | No | ||
| pickup | No | Required for custom rides and tours: agreed pickup address or hotel, preserved in review and confirmations. | |
| address | No | Fixed routes only: the non-airport pickup/drop-off address. The fare follows the route zone of the address (postcode first, then town name; a hotel or town named without a postcode is placed by a server-side lookup, and the selected route applies if that lookup fails). An address whose Dutch postcode is in no fixed-route zone is refused with error code address_zone; book it as a single ride. | |
| dropoff | No | Required for custom rides: drop-off address. | |
| payment | No | How the customer pays once the ride is confirmed: deposit = a payment request for 25% of the price, rest on the day of the ride; full = a payment request for the full price. With a returnTrip both legs are confirmed together and paid with ONE payment request on these terms (the sum over the legs). | deposit |
| routeId | No | Fixed routes only; ids from /data/rates.json. The server reprices to the route the address belongs to. | |
| tourIds | No | Tours only; ids from /data/tours.json. | |
| bookingId | Yes | The bookingId returned by request_booking. | |
| direction | No | Fixed routes only: to or from Schiphol. | |
| driverName | No | Optional. Name of a preferred driver, printed as "Driver: ..." in the customer's confirmation and calendar file. Leave it out unless the customer asks for a specific driver; it is not the passenger's name. | |
| passengers | Yes | ||
| quoteToken | Yes | Signed token returned by POST /api/quote. Send unchanged only after the customer approves that quote's total and payment. It binds the normalized journey, vehicle, passengers, payment choice, return trip, options, fare, rules version and 15-minute expiry. HTTP 409 reviewRequired=true means obtain a new quote and renewed customer approval before retrying. Never supply your own price. | |
| returnTrip | No | Airport transfers (fixed) and custom rides only; tours fail with retour_type, and a value that is not an object fails with retour. Books the return leg as well, with the same vehicle, passengers and luggage: on a fixed route the opposite direction between the same address and Schiphol, priced as a second ride at the route price; on a custom ride from the drop-off back to the pickup, where the fare estimate covers both legs and is split evenly over them. The return must be at least one hour after the first ride (retour_order), between 04:00 and 20:00 (retour_hours), not on a blocked date (retour_date_blocked) and at most 2 years ahead (date_range); missing or invalid values fail with retour_date, retour_time or retour_datetime. There is no name card on either leg (meet_greet_unavailable). The request is stored as two linked bookings, bookingId and `<bookingId>-ret` (so bookingId may have at most 51 characters when a returnTrip is sent), confirmed together and paid with one payment request: 25% of the combined price of the legs, or all of it with payment=full. | |
| luggageLarge | No | Large check-in suitcases. The BMW takes at most 3; more needs the V-Class (error code luggage). | |
| luggageSmall | No | Pieces of hand luggage. The BMW takes at most 3; more needs the V-Class (error code luggage). | |
| ticketService | No | Tours only: attraction ticket purchase assistance, requires 28 days' notice. |