Skip to content

Change a booking, or its dietary preferences and occasion

patch/api/book/{slug}/manage/{token}

A guest moves their own booking to another time. One endpoint for both engines: a manage link points at a booking, not at a product, so the engine is worked out from the booking and the caller does not choose.

Only the time changes: same service, same staff member, same party size. That is what lets a guest reschedule go through without staff review.

The new time must respect the venue's notice period too, so a guest cannot sidestep the cutoff by moving to a slot an hour from now. The slot is re-derived server-side, and a booking the venue cancelled mid-flow is not brought back.

Path Parameters

slug*string

The organization's public booking slug, i.e. the {slug} in /{slug}. Only orgs with status active resolve; anything else is a 404.

token*string

The booking's manage_token (a uuid) from its confirmation email. This IS the credential; there is no session. A non-uuid string is rejected before it reaches Postgres and reads as "link not valid".

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Properties1 <= properties

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/book/string/manage/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "reconfirmedAt": "2019-08-24T14:15:22Z",  "booking": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "starts_at": "2019-08-24T14:15:22Z",    "ends_at": "2019-08-24T14:15:22Z",    "party_size": 0  },  "details": {    "dietaryTags": [      "string"    ],    "occasion": "string"  }}