Change a booking

POST

/public/v1/bookings/{reference}/amend

const url = 'https://example.kwickbooking.com/public/v1/bookings/example/amend';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"phone":"07911 123456","date":"2026-10-16","time":"21:00","partySize":4,"notes":null,"venueId":null}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.kwickbooking.com/public/v1/bookings/example/amend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "phone": "07911 123456", "date": "2026-10-16", "time": "21:00", "partySize": 4, "notes": null, "venueId": null }'

Moves a booking to another date, time or party size, or changes its notes, keeping its reference. If the new time is full the answer is unavailable with alternatives and nothing changes. A change the venue doesn’t allow online (too many guests, too close to the booking, too far ahead, or a booking still waiting for its deposit) answers needs_venue and passes the request to the venue’s team. A bigger party may owe a deposit top-up. Send an Idempotency-Key header.

Authorizations

IntegrationKey

Parameters

Path Parameters

reference

required

string

Request Body^required

application/json

POST /public/v1/bookings/{reference}/amend: the phone on the booking and what to change (venue-local yyyy-MM-dd and HH:mm); a null keeps the current value.

object

phone

required

string

date

null | string

time

null | string

partySize

null | integer format: int32

notes

null | string

venueId

null | string format: uuid

Example

{
  "phone": "07911 123456",
  "date": "2026-10-16",
  "time": "21:00",
  "partySize": 4,
  "notes": null,
  "venueId": null
}

Responses

200

application/json

The answer to an amend or cancel: amended, cancelled or already_cancelled with the booking; unavailable with alternatives; or needs_venue with the enquiry raised for staff.

object

outcome

required

string

booking

required

One of:

null
object

null

alternatives

required

Array<object>

Another time, day or venue that fits when the asked one doesn’t.

object

venueId

required

string format: uuid

venueName

required

string

date

required

string

time

required

string

options

required

Array<object>

A booking type that fits a time, with its length and deposit.

object

bookingTypeId

required

string format: uuid

bookingType

required

string

durationMinutes

required

integer format: int32

deposit

required

A deposit as a guest would hear it.

object

required

required

boolean

amountPence

required

integer format: int32

amountDisplay

required

null | string

enquiryId

required

null | string format: uuid

depositTopUp

required

One of:

null
object

null

summary

required

string

Example

{
  "outcome": "amended",
  "booking": {
    "reference": "48271936",
    "venueId": "01920000-0000-7000-8000-000000000001",
    "venueName": "Soho",
    "date": "2026-10-16",
    "time": "20:00",
    "partySize": 4,
    "bookingType": "Table booking",
    "state": "confirmed",
    "guestFirstName": "Sam",
    "deposit": {
      "required": false,
      "amountPence": 0,
      "amountDisplay": null,
      "status": "none"
    },
    "expectedArrival": null
  },
  "alternatives": [],
  "enquiryId": null,
  "depositTopUp": null,
  "summary": "Done: your booking is now Fri 16/10 at 21:00 for 4."
}

400

Validation failed (https://developers.kwickblocks.ai/problems/validation-failed); Idempotency-Key required (https://developers.kwickblocks.ai/problems/idempotency-key-required)

application/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Validation failed

{
  "type": "https://developers.kwickblocks.ai/problems/validation-failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "Some of the details weren't valid. Please check them and try again."
}

Idempotency-Key required

{
  "type": "https://developers.kwickblocks.ai/problems/idempotency-key-required",
  "title": "Idempotency-Key required",
  "status": 400,
  "detail": "This request needs an Idempotency-Key header."
}

401

Invalid or missing integration key (https://developers.kwickblocks.ai/problems/invalid-key)

application/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

invalid-key

Invalid or missing integration key

{
  "type": "https://developers.kwickblocks.ai/problems/invalid-key",
  "title": "Invalid or missing integration key",
  "status": 401,
  "detail": "This integration key isn't valid. Ask the venue's admin for a new one."
}

403

Capability not granted (https://developers.kwickblocks.ai/problems/capability-missing)

application/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

capability-missing

Capability not granted

{
  "type": "https://developers.kwickblocks.ai/problems/capability-missing",
  "title": "Capability not granted",
  "status": 403,
  "detail": "This integration key isn't allowed to do that. Ask the venue's admin to add the capability."
}

404

Booking not found (https://developers.kwickblocks.ai/problems/booking-not-found)

application/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

booking-not-found

Booking not found

{
  "type": "https://developers.kwickblocks.ai/problems/booking-not-found",
  "title": "Booking not found",
  "status": 404,
  "detail": "I couldn't find a booking with that reference and phone number."
}

409

Booking can’t be changed (https://developers.kwickblocks.ai/problems/booking-not-changeable); Idempotency-Key conflict (https://developers.kwickblocks.ai/problems/idempotency-conflict)

application/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Booking can't be changed

{
  "type": "https://developers.kwickblocks.ai/problems/booking-not-changeable",
  "title": "Booking can't be changed",
  "status": 409,
  "detail": "This booking can't be changed any more."
}

Idempotency-Key conflict

{
  "type": "https://developers.kwickblocks.ai/problems/idempotency-conflict",
  "title": "Idempotency-Key conflict",
  "status": 409,
  "detail": "That Idempotency-Key was already used for a different request."
}

429

Too many requests (https://developers.kwickblocks.ai/problems/rate-limited); Too many attempts (https://developers.kwickblocks.ai/problems/lookup-throttled)

application/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object

type

required

string format: uri

title

required

string

status

required

integer format: int32

detail

required

Safe to read to a guest.

string

instance

string

traceId

string

code

A machine-readable code on the widget’s routes.

string

Examples

Too many requests

{
  "type": "https://developers.kwickblocks.ai/problems/rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "There have been too many requests. Please try again in a minute."
}

Too many attempts

{
  "type": "https://developers.kwickblocks.ai/problems/lookup-throttled",
  "title": "Too many attempts",
  "status": 429,
  "detail": "Too many attempts. Please try again later."
}

Change a booking

Authorizations

Parameters

Path Parameters

Request Bodyrequired

Example

Responses

200

Example

400

Examples

401

Examples

403

Examples

404

Examples

409

Examples

429

Examples

Request Body^required