Update booking settings

PATCH /api/v1/settings/booking

Changes the booking rules. Fields absent from the body keep their current value.

Authorization

Settings follow the right to change the organization itself.

Request body

Example

curl -X PATCH -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
  -d '{"bufferMinutes":45}' \
  "https://villaslot.app/api/v1/settings/booking"

Response

• 200 OK — the saved settings.

What it refuses

• 403 Forbidden — the key bearer is a member.
• 422 Unprocessable Entity — an unsupported currency or timezone, or a value outside its range.
• 401 Unauthorized — missing or invalid key, or a key whose bearer left the organization.
• 404 Not Found — unknown id, or an id belonging to another organization. The two are deliberately indistinguishable.
• 429 Too Many Requests — over 120 requests in a minute for this key.

Notes

• Changing the timezone changes how future date / startMinute pairs are read. It does not move a single existing booking: those are stored as instants.
• Changing the buffer applies to future bookings only; each booking keeps the buffer frozen on its line.