GuidesAPI ReferenceMCPChangelog
Appointments engine

Create a product category

post/api/products/categories

A named shelf products hang off on the Products list ("Hair care", "Tools"), purely for finding things; it never changes a price (migration 0176). New categories land at the end of the shelf (sort_order = max+1). v1 is flat, name-only: no rename or reorder route exists yet. Appointments only, see POST /api/products.

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

curl -X POST "https://example.com/api/products/categories" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "category": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string"  }}

Adjust a variant's stock POST

Same three reasons and two shapes POST /api/products/{id}/stock takes, calling book_product_variant_stock_adjust() (migration 20260918100000) against the variant's own stock_on_hand instead of the parent product's. **Appointments only**, see POST /api/products.

Delete a product category DELETE

Never blocks and never takes products with it: the composite FK's column-scoped `on delete set null (category_id)` (0176) un-groups them in the same statement, same shape book_service_groups' own DELETE takes. **Appointments only**, see POST /api/products.