BlockBookings

get

Retrieve a block booking with its member bookings (populated like the bookings list).

Path parameters

blockIdstringRequired

Query parameters

sitestringRequired

Responses

200

Default Response

No content

get

/block-bookings/{blockId}

HTTPcURLJavaScriptPython

GET /block-bookings/{blockId}?site=text HTTP/1.1
Host: api.kitehouse.co.uk
Accept: */*

200

Default Response

No content

delete

Archive a block booking (soft delete). Member bookings keep their block_booking ref so historical grouping is preserved.

Path parameters

blockIdstringRequired

Body

application/json

sitestringRequired

Responses

200

Default Response

No content

delete

/block-bookings/{blockId}

HTTPcURLJavaScriptPython

DELETE /block-bookings/{blockId} HTTP/1.1
Host: api.kitehouse.co.uk
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "site": "text"
}

200

Default Response

No content

patch

Edit a block booking's name or notes.

Path parameters

blockIdstringRequired

Body

application/json

sitestringRequired

namestring · min: 1Optional

notesstring · nullableOptional

Responses

200

Default Response

No content

patch

/block-bookings/{blockId}

HTTPcURLJavaScriptPython

PATCH /block-bookings/{blockId} HTTP/1.1
Host: api.kitehouse.co.uk
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "site": "text",
  "name": "text",
  "notes": null
}

200

Default Response

No content

post

Apply the same transition to every member booking of the block. Returns per-member success/failure so the caller can show a partial-success summary.

Path parameters

blockIdstringRequired

Body

application/json

sitestringRequired

typestring · enumRequiredPossible values:

occurred_atstringOptional

notesstringOptional

cancellation_codestringOptional

cancellation_reasonstringOptional

Responses

200

Default Response

No content

post

/block-bookings/{blockId}/transitions

HTTPcURLJavaScriptPython

POST /block-bookings/{blockId}/transitions HTTP/1.1
Host: api.kitehouse.co.uk
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "site": "text",
  "type": "check_in",
  "occurred_at": "text",
  "notes": "text",
  "cancellation_code": "text",
  "cancellation_reason": "text"
}

200

Default Response

No content