Shop API
Org-scoped cart and checkout under /api/shop/[orgSlug].
Shop cart APIs live under /api/shop/[orgSlug]/ (not /api/v1). The path slug must match the authenticated org.
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /api/shop/[orgSlug]/cart/items | Add a variant to the user's cart. |
PATCH | /api/shop/[orgSlug]/cart/items/[itemId] | Update quantity. |
DELETE | /api/shop/[orgSlug]/cart/items/[itemId] | Remove a line. |
POST | /api/shop/[orgSlug]/cart/[cartId]/checkout | Start checkout for a cart snapshot. |
POST | /api/shop/webhooks/ucp | Merchant UCP webhook (provider-verified, no session). |
See Shop for the dashboard UI flows.