Shared

Add a form to the catalog (admin)

post/api/forms

Same permission bar as PUT /api/intake and the same intake_forms PlanFeature: this is the other half of the one capability a business buys, not a new pricing decision. Not service-role: book_forms takes a plain tenant_all RLS policy, same posture book_intake_forms/book_products/book_packages all take for a catalog item a business edits directly. Shared by both engines: a form is not tied to book_services at all, unlike Packages, so there is no vertical split.

Authorization

sessionCookie
sb-qxrvgfkjyvbngipqvslu-auth-token<token>

The dashboard's Supabase Auth session cookie, set at sign-in. Large sessions are split across numbered chunks (…auth-token.0, .1), so treat this as a cookie family rather than one name.

Every request re-validates it against the Auth server (getUser()), never by decoding the cookie locally: a JWT nothing has checked is not a credential. Tenancy is then read from the verified app_metadata.company_id claim and enforced by row-level security; it is never read from request input, on any route, ever.

role (admin / staff) is deliberately not in RLS. It gates specific actions in route code, the operations marked admin below, so hiding a button in the UI is cosmetic only, and a route's own check is the enforcement.

In: cookie

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/forms" \  -H "Content-Type: application/json" \  -d '{    "title": "string",    "fields": [      {        "label": "string",        "type": "text"      }    ]  }'
{  "form": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"  }}

Erase a client's personal data on request (admin) POST

Closes the gap the privacy policy already names: a business is responsible for honouring its own customers' access/deletion requests, but no tool existed to actually fulfil one for a single guest; only DELETE /api/account (the whole workspace) did. Anonymises in place; never deletes the row. `book_appointments.customer_id`/`book_reservations.customer_id` are both `NOT NULL` with no `ON DELETE` clause, so a client with any booking history cannot be hard-deleted without also deleting that booking, which an erasure request never asked for. Clears `name` (replaced with "Erased guest"), `email`, `phone`, `notes`, `tags` and the birthday fields, and sets `marketingStatus` to `'unsubscribed'` permanently. Booking history, `id`, `company_id` and `created_at` are untouched. Never refuses on upcoming bookings: the count is reported instead, since refusing would let a venue stall a legitimate request indefinitely just by leaving one on the calendar. Writes an append-only `book_compliance_events` row (`customer_erased`) recording who did it and when. Idempotent: re-running this on an already-erased record just rewrites the same values and logs another event.

Edit a catalog form, or toggle active (admin) PATCH

Same shape PATCH /api/packages/{id} takes: a body of exactly `{ active: boolean }` toggles that flag alone; anything else is validated and written as a full replace via parseFormInput. No DELETE: book_form_sends references form_id with ON DELETE SET NULL rather than CASCADE, so a form already sent keeps its own snapshot regardless, but deactivating rather than deleting keeps the catalog list honest about what is still offered.