@proveanything/smartlinks 1.8.10 → 1.8.12

package/dist/openapi.yaml

@@ -41,6 +41,7 @@ tags:
   - name: journeys
   - name: journeysAnalytics
   - name: location
+  - name: loyalty
   - name: nfc
   - name: order
   - name: product
@@ -3382,6 +3383,39 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/CreateInteractionTypeBody"
+  /admin/collection/{collectionId}/interactions/aggregate:
+    post:
+      tags:
+        - interactions
+      summary: "POST /admin/collection/:collectionId/interactions/counts-by-outcome Returns array of { outcome, count }."
+      operationId: interactions_aggregate
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AdminInteractionsAggregateResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AdminInteractionsAggregateRequest"
   /admin/collection/{collectionId}/interactions/counts-by-outcome:
     post:
       tags:
@@ -3960,12 +3994,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders:
+  /admin/collection/{collectionId}/loyaltyScheme:
     get:
       tags:
-        - order
-      summary: List orders for a collection with optional filters and pagination.
-      operationId: order_list
+        - loyalty
+      summary: loyalty.list
+      operationId: loyalty_list
       security:
         - bearerAuth: []
       parameters:
@@ -3980,7 +4014,9 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListOrdersResponse"
+                type: array
+                items:
+                  $ref: "#/components/schemas/LoyaltyScheme"
         400:
           description: Bad request
         401:
@@ -3989,9 +4025,9 @@ paths:
           description: Not found
     post:
       tags:
-        - order
-      summary: Create a new order with items.
-      operationId: order_create
+        - loyalty
+      summary: loyalty.create
+      operationId: loyalty_create
       security:
         - bearerAuth: []
       parameters:
@@ -4006,7 +4042,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CreateOrderResponse"
+                $ref: "#/components/schemas/LoyaltyScheme"
         400:
           description: Bad request
         401:
@@ -4018,13 +4054,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateOrderRequest"
-  /admin/collection/{collectionId}/orders/analytics/bulk:
-    post:
+              $ref: "#/components/schemas/CreateLoyaltySchemeBody"
+  /admin/collection/{collectionId}/loyaltyScheme/{schemeId}:
+    get:
       tags:
-        - order
-      summary: Get analytics summary for multiple orders at once.
-      operationId: order_getBulkAnalytics
+        - loyalty
+      summary: loyalty.get
+      operationId: loyalty_get
       security:
         - bearerAuth: []
       parameters:
@@ -4033,31 +4069,29 @@ paths:
           required: true
           schema:
             type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/BulkAnalyticsResponse"
+                $ref: "#/components/schemas/LoyaltyScheme"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/BulkAnalyticsRequest"
-  /admin/collection/{collectionId}/orders/analytics/summary:
-    post:
+    patch:
       tags:
-        - order
-      summary: Get collection-wide analytics summary across all orders.
-      operationId: order_getCollectionSummary
+        - loyalty
+      summary: loyalty.update
+      operationId: loyalty_update
       security:
         - bearerAuth: []
       parameters:
@@ -4066,13 +4100,18 @@ paths:
           required: true
           schema:
             type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CollectionSummaryResponse"
+                $ref: "#/components/schemas/LoyaltyScheme"
         400:
           description: Bad request
         401:
@@ -4084,13 +4123,12 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/SummaryRequest"
-  /admin/collection/{collectionId}/orders/analytics/{orderId}:
-    post:
+              $ref: "#/components/schemas/UpdateLoyaltySchemeBody"
+    delete:
       tags:
-        - order
-      summary: order.getAnalytics
-      operationId: order_getAnalytics
+        - loyalty
+      summary: loyalty.remove
+      operationId: loyalty_remove
       security:
         - bearerAuth: []
       parameters:
@@ -4099,7 +4137,7 @@ paths:
           required: true
           schema:
             type: string
-        - name: orderId
+        - name: schemeId
           in: path
           required: true
           schema:
@@ -4110,19 +4148,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/OrderAnalyticsResponse"
+                $ref: "#/components/schemas/LoyaltyScheme"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/analytics/{orderId}/locations:
-    post:
+  /admin/collection/{collectionId}/loyaltyScheme/{schemeId}/earningRule:
+    get:
       tags:
-        - order
-      summary: "Get location-based scan history for an order's tags."
-      operationId: order_getLocationHistory
+        - loyalty
+      summary: loyalty.listEarningRules
+      operationId: loyalty_listEarningRules
       security:
         - bearerAuth: []
       parameters:
@@ -4131,7 +4169,7 @@ paths:
           required: true
           schema:
             type: string
-        - name: orderId
+        - name: schemeId
           in: path
           required: true
           schema:
@@ -4142,25 +4180,20 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/LocationResponse"
+                type: array
+                items:
+                  $ref: "#/components/schemas/LoyaltyEarningRule"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/LocationRequest"
-  /admin/collection/{collectionId}/orders/analytics/{orderId}/timeline:
     post:
       tags:
-        - order
-      summary: "Get chronological timeline of all scan events for an order's tags."
-      operationId: order_getTimeline
+        - loyalty
+      summary: loyalty.createEarningRule
+      operationId: loyalty_createEarningRule
       security:
         - bearerAuth: []
       parameters:
@@ -4169,7 +4202,7 @@ paths:
           required: true
           schema:
             type: string
-        - name: orderId
+        - name: schemeId
           in: path
           required: true
           schema:
@@ -4180,7 +4213,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TimelineResponse"
+                $ref: "#/components/schemas/LoyaltyEarningRule"
         400:
           description: Bad request
         401:
@@ -4192,13 +4225,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/TimelineRequest"
-  /admin/collection/{collectionId}/orders/ids/{attribute}/{value}:
+              $ref: "#/components/schemas/CreateLoyaltyEarningRuleBody"
+  /admin/collection/{collectionId}/loyaltyScheme/{schemeId}/earningRule/{ruleId}:
     get:
       tags:
-        - order
-      summary: Get unique order IDs containing items for a specific product.
-      operationId: order_getOrderIdsByAttribute
+        - loyalty
+      summary: loyalty.getEarningRule
+      operationId: loyalty_getEarningRule
       security:
         - bearerAuth: []
       parameters:
@@ -4207,12 +4240,12 @@ paths:
           required: true
           schema:
             type: string
-        - name: attribute
+        - name: schemeId
           in: path
           required: true
           schema:
             type: string
-        - name: value
+        - name: ruleId
           in: path
           required: true
           schema:
@@ -4223,19 +4256,18 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/GetOrderIdsResponse"
+                $ref: "#/components/schemas/LoyaltyEarningRule"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/lookup:
-    post:
+    patch:
       tags:
-        - order
-      summary: order.lookup
-      operationId: order_lookup
+        - loyalty
+      summary: loyalty.updateEarningRule
+      operationId: loyalty_updateEarningRule
       security:
         - bearerAuth: []
       parameters:
@@ -4244,13 +4276,23 @@ paths:
           required: true
           schema:
             type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: ruleId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/LookupOrdersResponse"
+                $ref: "#/components/schemas/LoyaltyEarningRule"
         400:
           description: Bad request
         401:
@@ -4262,13 +4304,12 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/LookupOrdersRequest"
-  /admin/collection/{collectionId}/orders/product/{productId}:
-    get:
+              $ref: "#/components/schemas/UpdateLoyaltyEarningRuleBody"
+    delete:
       tags:
-        - order
-      summary: Find all orders containing items with a specific product ID.
-      operationId: order_findByProduct
+        - loyalty
+      summary: loyalty.removeEarningRule
+      operationId: loyalty_removeEarningRule
       security:
         - bearerAuth: []
       parameters:
@@ -4277,7 +4318,12 @@ paths:
           required: true
           schema:
             type: string
-        - name: productId
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: ruleId
           in: path
           required: true
           schema:
@@ -4288,19 +4334,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/LookupByProductResponse"
+                $ref: "#/components/schemas/LoyaltyEarningRule"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/product/{productId}/items:
+  /admin/collection/{collectionId}/loyaltyScheme/{schemeId}/member/{contactId}:
     get:
       tags:
-        - order
-      summary: Get individual order items for a specific product.
-      operationId: order_findItemsByProduct
+        - loyalty
+      summary: loyalty.getMember
+      operationId: loyalty_getMember
       security:
         - bearerAuth: []
       parameters:
@@ -4309,7 +4355,12 @@ paths:
           required: true
           schema:
             type: string
-        - name: productId
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: contactId
           in: path
           required: true
           schema:
@@ -4320,19 +4371,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/FindItemsByAttributeResponse"
+                $ref: "#/components/schemas/LoyaltyMember"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/query:
+  /admin/collection/{collectionId}/loyaltyScheme/{schemeId}/member/{contactId}/transaction:
     post:
       tags:
-        - order
-      summary: order.query
-      operationId: order_query
+        - loyalty
+      summary: Manually award or deduct points for a contact.
+      operationId: loyalty_recordTransaction
       security:
         - bearerAuth: []
       parameters:
@@ -4341,13 +4392,23 @@ paths:
           required: true
           schema:
             type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: contactId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/QueryOrdersResponse"
+                $ref: "#/components/schemas/LoyaltyTransactionResult"
         400:
           description: Bad request
         401:
@@ -4359,13 +4420,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/QueryOrdersRequest"
-  /admin/collection/{collectionId}/orders/reports:
+              $ref: "#/components/schemas/RecordLoyaltyTransactionBody"
+  /admin/collection/{collectionId}/orders:
     get:
       tags:
         - order
-      summary: order.reports
-      operationId: order_reports
+      summary: List orders for a collection with optional filters and pagination.
+      operationId: order_list
       security:
         - bearerAuth: []
       parameters:
@@ -4380,19 +4441,18 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ReportsResponse"
+                $ref: "#/components/schemas/ListOrdersResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/{orderId}:
-    get:
+    post:
       tags:
         - order
-      summary: Get a single order by ID.
-      operationId: order_get
+      summary: Create a new order with items.
+      operationId: order_create
       security:
         - bearerAuth: []
       parameters:
@@ -4401,29 +4461,31 @@ paths:
           required: true
           schema:
             type: string
-        - name: orderId
-          in: path
-          required: true
-          schema:
-            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/GetOrderResponse"
+                $ref: "#/components/schemas/CreateOrderResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    put:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateOrderRequest"
+  /admin/collection/{collectionId}/orders/analytics/bulk:
+    post:
       tags:
         - order
-      summary: Update order status or metadata.
-      operationId: order_update
+      summary: Get analytics summary for multiple orders at once.
+      operationId: order_getBulkAnalytics
       security:
         - bearerAuth: []
       parameters:
@@ -4432,18 +4494,13 @@ paths:
           required: true
           schema:
             type: string
-        - name: orderId
-          in: path
-          required: true
-          schema:
-            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/UpdateOrderResponse"
+                $ref: "#/components/schemas/BulkAnalyticsResponse"
         400:
           description: Bad request
         401:
@@ -4455,12 +4512,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/UpdateOrderRequest"
-    delete:
+              $ref: "#/components/schemas/BulkAnalyticsRequest"
+  /admin/collection/{collectionId}/orders/analytics/summary:
+    post:
       tags:
         - order
-      summary: Delete an order and all its items (cascade delete).
-      operationId: order_remove
+      summary: Get collection-wide analytics summary across all orders.
+      operationId: order_getCollectionSummary
       security:
         - bearerAuth: []
       parameters:
@@ -4469,30 +4527,31 @@ paths:
           required: true
           schema:
             type: string
-        - name: orderId
-          in: path
-          required: true
-          schema:
-            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/DeleteOrderResponse"
+                $ref: "#/components/schemas/CollectionSummaryResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/{orderId}/items:
-    get:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SummaryRequest"
+  /admin/collection/{collectionId}/orders/analytics/{orderId}:
+    post:
       tags:
         - order
-      summary: Get items from an order with pagination support.
-      operationId: order_getItems
+      summary: order.getAnalytics
+      operationId: order_getAnalytics
       security:
         - bearerAuth: []
       parameters:
@@ -4512,18 +4571,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/GetOrderItemsResponse"
+                $ref: "#/components/schemas/OrderAnalyticsResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/orders/analytics/{orderId}/locations:
     post:
       tags:
         - order
-      summary: Add additional items to an existing order.
-      operationId: order_addItems
+      summary: "Get location-based scan history for an order's tags."
+      operationId: order_getLocationHistory
       security:
         - bearerAuth: []
       parameters:
@@ -4543,7 +4603,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AddItemsResponse"
+                $ref: "#/components/schemas/LocationResponse"
         400:
           description: Bad request
         401:
@@ -4555,13 +4615,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AddItemsRequest"
-  /admin/collection/{collectionId}/owner/{userId}:
-    get:
+              $ref: "#/components/schemas/LocationRequest"
+  /admin/collection/{collectionId}/orders/analytics/{orderId}/timeline:
+    post:
       tags:
-        - contact
-      summary: contact.getUser
-      operationId: contact_getUser
+        - order
+      summary: "Get chronological timeline of all scan events for an order's tags."
+      operationId: order_getTimeline
       security:
         - bearerAuth: []
       parameters:
@@ -4570,7 +4630,408 @@ paths:
           required: true
           schema:
             type: string
-        - name: userId
+        - name: orderId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TimelineResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TimelineRequest"
+  /admin/collection/{collectionId}/orders/ids/{attribute}/{value}:
+    get:
+      tags:
+        - order
+      summary: Get unique order IDs containing items for a specific product.
+      operationId: order_getOrderIdsByAttribute
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: attribute
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: value
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GetOrderIdsResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/orders/lookup:
+    post:
+      tags:
+        - order
+      summary: order.lookup
+      operationId: order_lookup
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LookupOrdersResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LookupOrdersRequest"
+  /admin/collection/{collectionId}/orders/product/{productId}:
+    get:
+      tags:
+        - order
+      summary: Find all orders containing items with a specific product ID.
+      operationId: order_findByProduct
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: productId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LookupByProductResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/orders/product/{productId}/items:
+    get:
+      tags:
+        - order
+      summary: Get individual order items for a specific product.
+      operationId: order_findItemsByProduct
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: productId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/FindItemsByAttributeResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/orders/query:
+    post:
+      tags:
+        - order
+      summary: order.query
+      operationId: order_query
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/QueryOrdersResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/QueryOrdersRequest"
+  /admin/collection/{collectionId}/orders/reports:
+    get:
+      tags:
+        - order
+      summary: order.reports
+      operationId: order_reports
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ReportsResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/orders/{orderId}:
+    get:
+      tags:
+        - order
+      summary: Get a single order by ID.
+      operationId: order_get
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: orderId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GetOrderResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    put:
+      tags:
+        - order
+      summary: Update order status or metadata.
+      operationId: order_update
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: orderId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/UpdateOrderResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateOrderRequest"
+    delete:
+      tags:
+        - order
+      summary: Delete an order and all its items (cascade delete).
+      operationId: order_remove
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: orderId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/DeleteOrderResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/orders/{orderId}/items:
+    get:
+      tags:
+        - order
+      summary: Get items from an order with pagination support.
+      operationId: order_getItems
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: orderId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GetOrderItemsResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    post:
+      tags:
+        - order
+      summary: Add additional items to an existing order.
+      operationId: order_addItems
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: orderId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AddItemsResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddItemsRequest"
+  /admin/collection/{collectionId}/owner/{userId}:
+    get:
+      tags:
+        - contact
+      summary: contact.getUser
+      operationId: contact_getUser
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: userId
           in: path
           required: true
           schema:
@@ -8240,6 +8701,157 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/loyaltyScheme:
+    get:
+      tags:
+        - loyalty
+      summary: List active schemes for a collection.
+      operationId: loyalty_publicList
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LoyaltyScheme"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /public/collection/{collectionId}/loyaltyScheme/me:
+    get:
+      tags:
+        - loyalty
+      summary: "List active earning rules for a scheme — useful for showing \"how to earn\" in a loyalty UI."
+      operationId: loyalty_publicGetMe
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LoyaltySchemeWithMembership"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /public/collection/{collectionId}/loyaltyScheme/{schemeId}:
+    get:
+      tags:
+        - loyalty
+      summary: List active schemes for a collection.
+      operationId: loyalty_publicGet
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LoyaltyScheme"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /public/collection/{collectionId}/loyaltyScheme/{schemeId}/earningRule:
+    get:
+      tags:
+        - loyalty
+      summary: List active schemes for a collection.
+      operationId: loyalty_publicListEarningRules
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LoyaltyEarningRule"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /public/collection/{collectionId}/loyaltyScheme/{schemeId}/member/me:
+    get:
+      tags:
+        - loyalty
+      summary: "Get all active schemes with the caller's membership embedded in each."
+      operationId: loyalty_publicGetMine
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: schemeId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LoyaltyMember"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /public/collection/{collectionId}/product/{productId}/asset:
     get:
       tags:
@@ -15745,34 +16357,131 @@ components:
           type: boolean
         order:
           type: string
-          enum:
-            - ASC
-            - DESC
-        include:
+          enum:
+            - ASC
+            - DESC
+        include:
+          type: array
+          items:
+            type: string
+            enum:
+              - interaction
+    AdminInteractionsCountsByOutcomeRequest:
+      type: object
+      properties:
+        appId:
+          type: string
+        interactionId:
+          type: string
+        scope:
+          type: string
+        from:
+          type: string
+        to:
+          type: string
+        limit:
+          type: number
+        dedupeLatest:
+          type: boolean
+        idField:
+          $ref: "#/components/schemas/IdField"
+    AdminInteractionsAggregateRequest:
+      type: object
+      properties:
+        appId:
+          type: string
+        interactionId:
+          type: string
+        interactionIds:
+          type: array
+          items:
+            type: string
+        scope:
+          type: string
+        outcome:
+          type: string
+        from:
+          type: string
+        to:
+          type: string
+        limit:
+          type: number
+        dedupeLatest:
+          type: boolean
+        groupBy:
+          type: string
+        aggregate:
+          type: object
+          additionalProperties: true
+        field:
+          type: string
+        ops:
           type: array
           items:
             type: string
             enum:
-              - interaction
-    AdminInteractionsCountsByOutcomeRequest:
+              - count
+              - sum
+              - avg
+              - min
+              - max
+      required:
+        - groupBy
+        - aggregate
+        - field
+        - ops
+    AdminInteractionsAggregateResponse:
       type: object
       properties:
-        appId:
-          type: string
-        interactionId:
-          type: string
-        scope:
-          type: string
-        from:
+        groupBy:
           type: string
-        to:
+        aggregate:
+          type: object
+          additionalProperties: true
+        field:
           type: string
-        limit:
-          type: number
+        ops:
+          type: array
+          items:
+            type: string
+            enum:
+              - count
+              - sum
+              - avg
+              - min
+              - max
         dedupeLatest:
           type: boolean
-        idField:
-          $ref: "#/components/schemas/IdField"
+        rows:
+          type: array
+          items:
+            $ref: "#/components/schemas/AdminInteractionsAggregateRow"
+      required:
+        - groupBy
+        - aggregate
+        - field
+        - ops
+        - rows
+    AdminInteractionsAggregateRow:
+      type: object
+      properties:
+        groupValue:
+          type: string
+        eventCount:
+          type: number
+        count:
+          type: number
+        sum:
+          type: number
+        avg:
+          type: number
+        min:
+          type: number
+        max:
+          type: number
+      required:
+        - groupValue
+        - eventCount
     PublicInteractionsCountsByOutcomeRequest:
       type: object
       properties:
@@ -16442,6 +17151,293 @@ components:
       required:
         - items
         - count
+    LoyaltyScheme:
+      type: object
+      properties:
+        id:
+          type: string
+        orgId:
+          type: string
+        collectionId:
+          type: string
+        name:
+          type: string
+        type:
+          type: string
+        active:
+          type: boolean
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        deletedAt:
+          type: string
+        data:
+          $ref: "#/components/schemas/DataBlock"
+        owner:
+          $ref: "#/components/schemas/DataBlock"
+        admin:
+          $ref: "#/components/schemas/DataBlock"
+      required:
+        - id
+        - orgId
+        - collectionId
+        - name
+        - type
+        - active
+        - createdAt
+        - updatedAt
+        - deletedAt
+        - data
+    LoyaltyMember:
+      type: object
+      properties:
+        id:
+          type: string
+        orgId:
+          type: string
+        collectionId:
+          type: string
+        schemeId:
+          type: string
+        contactId:
+          type: string
+        userId:
+          type: string
+        balance:
+          type: number
+        lifetimePoints:
+          type: number
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        data:
+          $ref: "#/components/schemas/DataBlock"
+        owner:
+          $ref: "#/components/schemas/DataBlock"
+        admin:
+          $ref: "#/components/schemas/DataBlock"
+      required:
+        - id
+        - orgId
+        - collectionId
+        - schemeId
+        - contactId
+        - userId
+        - balance
+        - lifetimePoints
+        - createdAt
+        - updatedAt
+        - data
+    LoyaltyTransaction:
+      type: object
+      properties:
+        id:
+          type: string
+        orgId:
+          type: string
+        collectionId:
+          type: string
+        schemeId:
+          type: string
+        memberId:
+          type: string
+        points:
+          type: number
+        reason:
+          type: string
+        idempotencyKey:
+          type: string
+        metadata:
+          $ref: "#/components/schemas/DataBlock"
+        createdAt:
+          type: string
+      required:
+        - id
+        - orgId
+        - collectionId
+        - schemeId
+        - memberId
+        - points
+        - reason
+        - idempotencyKey
+        - metadata
+        - createdAt
+    LoyaltyEarningRule:
+      type: object
+      properties:
+        id:
+          type: string
+        orgId:
+          type: string
+        collectionId:
+          type: string
+        schemeId:
+          type: string
+        interactionId:
+          type: string
+        points:
+          type: number
+        conditions:
+          type: object
+          additionalProperties:
+            type: string
+        maxPerContact:
+          type: number
+        cooldownHours:
+          type: number
+        active:
+          type: boolean
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        data:
+          $ref: "#/components/schemas/DataBlock"
+      required:
+        - id
+        - orgId
+        - collectionId
+        - schemeId
+        - interactionId
+        - points
+        - conditions
+        - maxPerContact
+        - cooldownHours
+        - active
+        - createdAt
+        - updatedAt
+        - data
+    LoyaltySchemeWithMembership:
+      type: object
+      properties:
+        member:
+          type: string
+          enum:
+            - owner
+            - admin
+      required:
+        - member
+    LoyaltyTransactionResult:
+      type: object
+      properties:
+        member:
+          $ref: "#/components/schemas/LoyaltyMember"
+        transaction:
+          $ref: "#/components/schemas/LoyaltyTransaction"
+      required:
+        - member
+        - transaction
+    LoyaltyPaginationParams:
+      type: object
+      properties:
+        limit:
+          type: number
+        offset:
+          type: number
+    LoyaltyPaginatedResult:
+      type: object
+      properties:
+        items:
+          type: array
+          items:
+            $ref: "#/components/schemas/T"
+        limit:
+          type: number
+        offset:
+          type: number
+      required:
+        - items
+        - limit
+        - offset
+    CreateLoyaltySchemeBody:
+      type: object
+      properties:
+        name:
+          type: string
+        type:
+          type: string
+        active:
+          type: boolean
+        data:
+          $ref: "#/components/schemas/DataBlock"
+        owner:
+          $ref: "#/components/schemas/DataBlock"
+        admin:
+          $ref: "#/components/schemas/DataBlock"
+      required:
+        - name
+        - type
+    UpdateLoyaltySchemeBody:
+      type: object
+      properties:
+        name:
+          type: string
+        type:
+          type: string
+        active:
+          type: boolean
+        data:
+          $ref: "#/components/schemas/DataBlock"
+        owner:
+          $ref: "#/components/schemas/DataBlock"
+        admin:
+          $ref: "#/components/schemas/DataBlock"
+    CreateLoyaltyEarningRuleBody:
+      type: object
+      properties:
+        interactionId:
+          type: string
+        points:
+          type: number
+        conditions:
+          type: object
+          additionalProperties:
+            type: string
+        maxPerContact:
+          type: number
+        cooldownHours:
+          type: number
+        active:
+          type: boolean
+        data:
+          $ref: "#/components/schemas/DataBlock"
+      required:
+        - interactionId
+        - points
+    UpdateLoyaltyEarningRuleBody:
+      type: object
+      properties:
+        points:
+          type: number
+        conditions:
+          type: object
+          additionalProperties:
+            type: string
+        maxPerContact:
+          type: number
+        cooldownHours:
+          type: number
+        active:
+          type: boolean
+        data:
+          $ref: "#/components/schemas/DataBlock"
+    RecordLoyaltyTransactionBody:
+      type: object
+      properties:
+        points:
+          type: number
+        reason:
+          type: string
+        idempotencyKey:
+          type: string
+        metadata:
+          $ref: "#/components/schemas/DataBlock"
+        userId:
+          type: string
+      required:
+        - points
     NfcTagInfo:
       type: object
       properties: