Create or replace an intake form (admin)
/api/intakeOne form per target, where the target is either a single service or the whole org. serviceId: null means "every booking in this org", which is also what a table-reservations org always uses; it has no services. Two partial unique indexes in migration 0024 make that unambiguous, and this route upserts against them by reading first: PostgREST's onConflict emits a bare ON CONFLICT (company_id, service_id), which Postgres cannot infer against an index carrying a WHERE clause.
Written with the caller's own RLS-scoped client, NOT service-role. Unlike book_notification_templates, 0024 gives book_intake_forms a plain tenant policy, so RLS plus the JWT company_id claim already is the boundary. The composite foreign key means a serviceId belonging to another org is refused by the database rather than by route code, and surfaces as a 400.
There is no DELETE, deliberately. book_intake_responses references the form on delete cascade, so dropping a form would take every answer any guest ever gave with it, and a submitted intake is a record. active: false is the retire switch and it is part of this body.
Shared by both engines and therefore NOT vertical-guarded: a form asks a guest questions, which is plumbing like customers and notifications, not booking logic.
Authorization
sessionCookie 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
application/json
curl -X PUT "https://example.com/api/intake" \ -H "Content-Type: application/json" \ -d '{ "title": "string", "fields": [ { "label": "string", "type": "text" } ] }'{ "ok": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}Write the private staff note on a booking or enquiry PATCH
Its own route rather than a field on any guest-facing handler, so there is no code path where a note can be written by the same request that renders something to a customer. Nothing guest-facing selects `internal_note`, and the guest-side loader names its columns explicitly so it cannot start doing so by accident. An empty note clears the column rather than storing a blank string, so "has a note" stays a null check everywhere else. This is the BOOKING-level note. The other level; the one that follows the person across every booking; is `book_customers.notes`, written through PATCH /api/clients/{id}.
Set the guest self-service policy (admin, or manage_org_settings) PATCH
Deliberately NOT folded into PATCH /api/companies: these two columns sit outside migration 0022's tenant column grant and are written with service-role, while most of /api/companies is tenant-writable. A true partial update, same `has()` discipline as /api/companies: only a key actually present in the body is written, and at least one of the two must be sent or the whole request is a 400. Gated to admin, or a staff login granted `manage_org_settings` (migration 0082): this decides what every customer of the org may do to their own booking without asking staff, which is an org-settings decision rather than front-of-house work.