Skip to Content
Developers
Bookings

Move a booking

POST
/bookings/{id}/reschedule

Moves a booking to another time, and to another staff member when staff_id is sent. The customer gets the shop's mail about the move. As customer the shop's cut-off for moving applies.

Keys: a key that may read and change. Any other key gets 403.

Authorization

apiKey
headerAuthorizationBearer wo_live_...

A key from the shop's admin. Secret keys start with wo_live_, public keys with wo_pub_.

Path parameters

id*string

The object's id.

Formatuuid

Header parameters

Idempotency-Key?string

Any unique text, such as a UUID. A retry with the same key and the same request gets the first answer back and changes nothing twice. Kept for 24 hours.

Lengthlength <= 255

Request body

application/json
  1. body
as?string

customer keeps the shop's rules, such as how late a booking may still be cancelled. staff acts as the shop and skips them.

Default"customer"
Value in"customer""staff"
staff_id?string

Move it to this staff member as well.

Formatuuid
starts_at*string

The new start, a starts_at from GET /availability.

Formatdate-time

Response body

The request worked.

application/json
  1. response

An appointment.

cancel_reason*string

Empty unless cancelled.

cancelled_at*|null
code*string

The short code the customer sees.

comments*string

What the customer wrote when booking.

created_at*string

When the booking was made.

Formatdate-time
currency*string

ISO 4217 code of every amount on this object.

customer*

Who the booking is for, as written on the booking when it was made.

discount_percent*integer

Percent off the list price. 0 without a deal.

ends_at*string

When the appointment ends.

Formatdate-time
id*string

The booking's id.

Formatuuid
list_price_cents*integer

The price before any deal.

locale*string

The language the customer's mail about it goes out in.

minutes*integer

How long the appointment takes.

object*string
payment*|null
price_cents*integer

The price the customer was promised, VAT included.

service*
source*string

web for an online booking, admin for one staff typed in.

Value in"web""admin"
staff_id*string

Who the booking is with.

Formatuuid
starts_at*string

When the appointment starts.

Formatdate-time
status*string

confirmed is booked and still to come or not yet closed by staff. completed is done. no_show means the customer did not come.

Value in"confirmed""completed""cancelled""no_show"
updated_at*string

When the booking last changed.

Formatdate-time
Example request
curl -X POST 'https://api.weerom.com/v1/bookings/497f6eca-6276-4993-bfeb-53cbbbba6f08/reschedule' \  -H 'Content-Type: application/json' \  -d '{  "starts_at": "2026-12-01T13:30:00.000Z"}'
Example response
{  "cancel_reason": "",  "cancelled_at": null,  "code": "UEAMEFC9",  "comments": "",  "created_at": "2026-11-18T14:02:11.000Z",  "currency": "EUR",  "customer": {    "email": "[email protected]",    "id": "5f0c9d3a-7b2e-4c61-8a4d-9e1f3b6c2d75",    "name": "Lotte Peeters",    "phone": "+32470123456"  },  "discount_percent": 0,  "ends_at": "2026-11-21T10:15:00.000Z",  "id": "0b6f2a4e-5d1c-4f7a-9a3e-2c8d1e6f4b90",  "list_price_cents": 4000,  "locale": "nl",  "minutes": 45,  "object": "booking",  "payment": {    "amount_cents": 4000,    "method": "bancontact",    "paid_at": "2026-11-21T10:12:40.000Z",    "tip_cents": 200  },  "price_cents": 4000,  "service": {    "id": "c2a41f6e-8d3b-4e97-b5a0-1f7c9e2d4a68",    "name": "Knippen en baard"  },  "source": "web",  "staff_id": "8e1d5b7c-3a9f-4d20-b6c4-7a2e0f9d1c53",  "starts_at": "2026-11-21T09:30:00.000Z",  "status": "completed",  "updated_at": "2026-11-21T10:12:40.000Z"}

Details

Keys

Write key

Any other kind of key answers 403 key_not_allowed.

What it does

  • The booking keeps its id, code and service. starts_at and ends_at move, and staff_id changes when you send it.
  • The customer gets the shop's mail about the move when the booking has an email.

Webhooks

A call that works sends booking.updated to the shop's webhook addresses that listen for it. See Webhooks.

Errors

Besides 401 for a missing, unknown or removed key, 403 plan_required, 429 rate_limited and 500 internal_error, which every endpoint can answer. Errors has all of them.

StatuscodeWhenWhat to do
400invalid_requestA field is malformed, or the new staff member does not do the booking's service.Pick a staff member whose service_ids hold the booking's service.
404not_foundNo booking has this id, or no staff member has the staff_id you sent.Check the booking id and the staff_id.
409wrong_stateThe booking's status is not confirmed, or it is not linked to a service.Read the booking with GET /bookings/{id} and show its status.
409too_lateAs customer, the start is closer than the shop's cut-off for moving online.Tell the customer to call the shop, or send "as": "staff" to act as the shop.
409slot_takenThe new time is not one the shop offers, or someone booked it first.Ask GET /availability for the booking's service again and pick another time.
409idempotency_mismatchThe Idempotency-Key was used before for a request with another method, path or body.Make a new Idempotency-Key for a new request.
409request_in_progressThe first request with this Idempotency-Key still runs.Wait a second and send the same request with the same key again.