A product's recent stock movements
/api/products/{id}/stockThe last 20 rows off the append-only book_product_stock_movements ledger, newest first: backs the Adjust stock dialog's own recent-movements list. RLS-scoped read; any signed-in member may read it, no manage_services gate. Appointments only, see POST /api/products.
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
Path Parameters
Product id.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/products/string/stock"{ "movements": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "reason": "received", "delta": 0, "resulting_stock": 0, "note": "string", "created_at": "2019-08-24T14:15:22Z" } ]}Remove a product image DELETE
Deletes the stored object and nulls `image_url`. Storage removal is best-effort and its failure does not fail the request. **Appointments only**, see POST /api/products.
Adjust a product's stock POST
Three reasons, two shapes. `received` and `damaged` send a signed `delta` (the route itself flips the sign for `damaged` client-side, BeNotely's own "how many you're removing" framing, never a typed minus). `stocktake` sends the counted `count` instead; book_product_stock_adjust() (migration 0176) computes the delta against the LIVE, row-locked current value, never a value the client read moments earlier. Every call writes a reasoned book_product_stock_movements row. **Appointments only**, see POST /api/products.