API reference

Every endpoint SwagByte exposes, grouped by resource. Click an endpoint id to anchor-link directly to it (used by the sidebar). All endpoints accept and return JSON unless noted; errors follow { error: string } with an appropriate HTTP status.

Products

GET/api/productspublic

List products with optional category + active filters.

GET/api/products/{productId}public

Fetch a single product by product_id.

Designs

GET/api/account/designsowner

List saved designs for the calling owner (auth or guest).

POST/api/account/designsowner

Create a new saved design. Mints sb_anon for guests if missing.

PUT/api/account/designs/{id}owner

Overwrite the live design row in place. Returns 409 on stale expected_version_id.

GET/api/account/designs/{id}/versionsowner

List version snapshots, newest first.

POST/api/account/designs/{id}/versions/{versionId}/restoreowner

Revert the live row to a snapshot. 410 if archived.

Cart

GET/api/account/cartowner

Get the active cart for the calling owner.

PUT/api/account/cartowner

Replace the active cart's items. Inventory holds for auth users.

Checkout

POST/api/checkout/submitowner

Submit a checkout. Intents: pay_now, quote_only, po_deposit, po_net_terms.

POST/api/checkout/quotepublic

Compute a totals quote (subtotal + shipping + tax) without submitting.

Orders

GET/api/orders/guest-lookuppublic

Magic-link order lookup for guests (token query param).

GET/api/orders/by-number/{orderNumber}owner

Fetch an order by order_number, owner-gated.

Need full request/response bodies?

Per-endpoint detail pages with curl examples + typed schemas land in a follow-up round. Until then, the source endpoints live under src/app/api/ in the codebase.