Stores and settings

Merchant routes

• GET, POST /storefront/stores/: list accessible stores or create a store.
• GET, PATCH, PUT, DELETE /storefront/stores/{id}/: retrieve or manage one accessible store. Use the UUID from the list response.
• GET, POST /storefront/stores/{store_id}/hours/ and GET, PUT, DELETE /storefront/stores/{store_id}/hours/{id}/: opening hours.
• GET, POST /storefront/stores/{store_id}/closures/ and detail routes: closures.
• GET, POST /storefront/stores/{store_id}/delivery-zones/ and detail routes: merchant-defined delivery zones.
• GET, POST /storefront/stores/{store_id}/staff/ and GET, PATCH, DELETE /storefront/stores/{store_id}/staff/{id}/: scoped staff management.

Store publication, theme, domain and delivery configuration are validated by the API. A draft client store cannot be used for live checkout until claim and publish gates are satisfied.

Public routes

• GET /storefront/stores/{slug}/: published store detail.
• GET /storefront/directory/: public store directory.
• GET /storefront/stores/{slug}/delivery-zones/: checkout delivery options.
• GET /storefront/search/products/?q=...&store=...: public product search.