@proveanything/smartlinks 2.1.8 → 2.1.11

package/openapi.yaml

@@ -64,6 +64,8 @@ tags:
     description: blocks API
   - name: broadcasts
     description: Broadcast messaging campaigns.
+  - name: ranges
+    description: ranges API
   - name: collection
     description: Collection (tenant) configuration and resources.
   - name: comms
@@ -100,6 +102,8 @@ tags:
     description: NFC tag encoding and lookup.
   - name: order
     description: Order records and line items.
+  - name: partner
+    description: partner API
   - name: product
     description: Single product operations.
   - name: products
@@ -8994,6 +8998,149 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TransactionalSendRequest"
+  /admin/partner:
+    get:
+      tags:
+        - partner
+      summary: The partners you belong to, with your role in each.
+      operationId: partner_list
+      security:
+        - bearerAuth: []
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Partner"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/partner/{partnerId}:
+    get:
+      tags:
+        - partner
+      summary: One partner (owners also see its members).
+      operationId: partner_get
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: partnerId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Partner"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/partner/{partnerId}/claimSet:
+    get:
+      tags:
+        - partner
+      summary: "The partner's claim sets."
+      operationId: partner_claimSets
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: partnerId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/PartnerClaimSet"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    post:
+      tags:
+        - partner
+      summary: A new claim set for the partner, on one of its tap domains (owners and admins).
+      operationId: partner_createClaimSet
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: partnerId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PartnerClaimSet"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreatePartnerClaimSetRequest"
+  /admin/partner/{partnerId}/claimSet/{claimSetId}:
+    get:
+      tags:
+        - partner
+      summary: "One of the partner's claim sets."
+      operationId: partner_getClaimSet
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: partnerId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: claimSetId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PartnerClaimSet"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /authKit/{authKitId}/config:
     get:
       tags:
@@ -14734,96 +14881,40 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /{zone}/collection/{collectionId}/app/{appId}/cases:
+  /{rangeId}:
     get:
       tags:
-        - cases
-      summary: List cases with optional query parameters GET /cases
-      operationId: cases_list
+        - ranges
+      summary: One range, with its counts refreshed.
+      operationId: ranges_get
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
+        - name: rangeId
           in: path
           required: true
           schema:
             type: string
-        - name: category
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: priority
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: ref
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: proofId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: contactId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: assignedTo
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: closedAt
-          in: query
-          required: false
-          schema:
-            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                type: object
-                additionalProperties: true
+                $ref: "#/components/schemas/ClaimSetRange"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    post:
+    patch:
       tags:
-        - cases
-      summary: Create a new case POST /cases
-      operationId: cases_create
+        - ranges
+      summary: Name, notes, order details, or a stage move (sent to the printer, received).
+      operationId: ranges_update
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
+        - name: rangeId
           in: path
           required: true
           schema:
@@ -14834,7 +14925,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppCase"
+                $ref: "#/components/schemas/ClaimSetRange"
         400:
           description: Bad request
         401:
@@ -14846,26 +14937,16 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateCaseInput"
-  /{zone}/collection/{collectionId}/app/{appId}/cases/aggregate:
+              $ref: "#/components/schemas/UpdateClaimSetRangeRequest"
+  /{rangeId}/assign:
     post:
       tags:
-        - cases
-      summary: Get aggregate statistics for cases POST /cases/aggregate
-      operationId: cases_aggregate
+        - ranges
+      summary: Point the range (or from–to within it) at a collection / product / batch, or clear it.
+      operationId: ranges_assign
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
+        - name: rangeId
           in: path
           required: true
           schema:
@@ -14876,7 +14957,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AggregateResponse"
+                $ref: "#/components/schemas/AssignClaimSetRangeResponse"
         400:
           description: Bad request
         401:
@@ -14888,26 +14969,42 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AggregateRequest"
-  /{zone}/collection/{collectionId}/app/{appId}/cases/summary:
-    post:
+              $ref: "#/components/schemas/AssignClaimSetRangeRequest"
+  /{rangeId}/export:
+    get:
       tags:
-        - cases
-      summary: Get case summary (admin only) POST /cases/summary
-      operationId: cases_summary
+        - ranges
+      summary: "The printer file (CSV text in `csv`)."
+      operationId: ranges_exportFile
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
+        - name: rangeId
           in: path
           required: true
           schema:
             type: string
-        - name: appId
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ClaimSetRangeFile"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /{rangeId}/import:
+    post:
+      tags:
+        - ranges
+      summary: "The manufacturer's file back: check it (commit false), then write the chip UIDs (commit true)."
+      operationId: ranges_importUids
+      security: []
+      parameters:
+        - name: rangeId
           in: path
           required: true
           schema:
@@ -14918,7 +15015,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CaseSummaryResponse"
+                $ref: "#/components/schemas/ImportClaimSetRangeUidsResponse"
         400:
           description: Bad request
         401:
@@ -14930,31 +15027,16 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CaseSummaryRequest"
-  /{zone}/collection/{collectionId}/app/{appId}/cases/{caseId}:
+              $ref: "#/components/schemas/ImportClaimSetRangeUidsRequest"
+  /{rangeId}/instructions:
     get:
       tags:
-        - cases
-      summary: "Get a single case by ID GET /cases/:caseId"
-      operationId: cases_get
+        - ranges
+      summary: "The manufacturer's instruction sheet: PDF (base64) or Markdown."
+      operationId: ranges_instructions
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: caseId
+        - name: rangeId
           in: path
           required: true
           schema:
@@ -14965,36 +15047,22 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppCase"
+                $ref: "#/components/schemas/ClaimSetRangeFile"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    patch:
+  /{rangeId}/next:
+    get:
       tags:
-        - cases
-      summary: "Update a case PATCH /cases/:caseId Admin can update any field, public (owner) can only update data and owner zones"
-      operationId: cases_update
+        - ranges
+      summary: The next tag to program on a phone (lowest index without a chip), with its URL and key.
+      operationId: ranges_next
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: caseId
+        - name: rangeId
           in: path
           required: true
           schema:
@@ -15005,43 +15073,22 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppCase"
+                $ref: "#/components/schemas/ClaimSetRangeNextTag"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/UpdateCaseInput"
-  /{zone}/collection/{collectionId}/app/{appId}/cases/{caseId}/history:
+  /{rangeId}/resume:
     post:
       tags:
-        - cases
-      summary: "Append an entry to case history (admin only) POST /cases/:caseId/history"
-      operationId: cases_appendHistory
+        - ranges
+      summary: Finish minting a range that was interrupted.
+      operationId: ranges_resume
       security: []
       parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: caseId
+        - name: rangeId
           in: path
           required: true
           schema:
@@ -15052,7 +15099,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppCase"
+                $ref: "#/components/schemas/ClaimSetRange"
         400:
           description: Bad request
         401:
@@ -15064,33 +15111,33 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AppendHistoryInput"
-  /{zone}/collection/{collectionId}/app/{appId}/cases/{caseId}/related:
+              $ref: "#/components/schemas/ClaimSetScope"
+  /{rangeId}/tags:
     get:
       tags:
-        - cases
-      summary: "Get related threads and records for a case (admin only) GET /cases/:caseId/related"
-      operationId: cases_related
+        - ranges
+      summary: "The range's tags in index order, a page at a time (keys: owners/admins only)."
+      operationId: ranges_tags
       security: []
       parameters:
-        - name: zone
+        - name: rangeId
           in: path
           required: true
           schema:
             type: string
-        - name: collectionId
-          in: path
-          required: true
+        - name: from
+          in: query
+          required: false
           schema:
             type: string
-        - name: appId
-          in: path
-          required: true
+        - name: limit
+          in: query
+          required: false
           schema:
             type: string
-        - name: caseId
-          in: path
-          required: true
+        - name: keys
+          in: query
+          required: false
           schema:
             type: string
       responses:
@@ -15099,19 +15146,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/RelatedResponse"
+                $ref: "#/components/schemas/ClaimSetRangeTagsPage"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /{zone}/collection/{collectionId}/app/{appId}/records:
+  /{zone}/collection/{collectionId}/app/{appId}/cases:
     get:
       tags:
-        - records
-      summary: "List records with optional query parameters GET /records Public/owner callers only receive records with `status: \"active\"`."
-      operationId: records_list
+        - cases
+      summary: List cases with optional query parameters GET /cases
+      operationId: cases_list
       security: []
       parameters:
         - name: zone
@@ -15129,12 +15176,12 @@ paths:
           required: true
           schema:
             type: string
-        - name: status
+        - name: category
           in: query
           required: false
           schema:
             type: string
-        - name: recordType
+        - name: priority
           in: query
           required: false
           schema:
@@ -15144,106 +15191,26 @@ paths:
           required: false
           schema:
             type: string
-        - name: refPrefix
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: customId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: sourceSystem
-          in: query
-          required: false
-          schema:
-            type: string
         - name: proofId
           in: query
           required: false
           schema:
             type: string
-        - name: variantId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: batchId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: q
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: qFields
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: dataFilter
-          in: query
-          required: false
-          schema:
-            type: object
-            additionalProperties:
-              type: array
-              items:
-                type: object
-                additionalProperties: true
-        - name: authorId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: parentType
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: parentId
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: startsAt
-          in: query
-          required: false
-          schema:
-            type: string
-        - name: expiresAt
+        - name: contactId
           in: query
           required: false
           schema:
             type: string
-        - name: includeScheduled
-          in: query
-          required: false
-          schema:
-            type: boolean
-        - name: includeExpired
-          in: query
-          required: false
-          schema:
-            type: boolean
-        - name: at
+        - name: assignedTo
           in: query
           required: false
           schema:
             type: string
-        - name: contactId
+        - name: closedAt
           in: query
           required: false
           schema:
             type: string
-        - name: includeDeleted
-          in: query
-          required: false
-          schema:
-            type: boolean
       responses:
         200:
           description: Success
@@ -15260,9 +15227,9 @@ paths:
           description: Not found
     post:
       tags:
-        - records
-      summary: "Create a new record POST /records When called on the public endpoint (admin = false) with an anonymous caller, and the app's `publicCreate.records.anonymous.edit.editToken` policy is enabled, the response includes a one-time `editToken` string."
-      operationId: records_create
+        - cases
+      summary: Create a new case POST /cases
+      operationId: cases_create
       security: []
       parameters:
         - name: zone
@@ -15286,7 +15253,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CreateRecordResponse"
+                $ref: "#/components/schemas/AppCase"
         400:
           description: Bad request
         401:
@@ -15298,13 +15265,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateRecordInput"
-  /{zone}/collection/{collectionId}/app/{appId}/records/aggregate:
+              $ref: "#/components/schemas/CreateCaseInput"
+  /{zone}/collection/{collectionId}/app/{appId}/cases/aggregate:
     post:
       tags:
-        - records
-      summary: Get aggregate statistics for records POST /records/aggregate
-      operationId: records_aggregate
+        - cases
+      summary: Get aggregate statistics for cases POST /cases/aggregate
+      operationId: cases_aggregate
       security: []
       parameters:
         - name: zone
@@ -15341,12 +15308,12 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/AggregateRequest"
-  /{zone}/collection/{collectionId}/app/{appId}/records/bulk-delete:
+  /{zone}/collection/{collectionId}/app/{appId}/cases/summary:
     post:
       tags:
-        - records
-      summary: Soft-delete records in bulk.
-      operationId: records_bulkDelete
+        - cases
+      summary: Get case summary (admin only) POST /cases/summary
+      operationId: cases_summary
       security: []
       parameters:
         - name: zone
@@ -15370,7 +15337,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/BulkDeleteResult"
+                $ref: "#/components/schemas/CaseSummaryResponse"
         400:
           description: Bad request
         401:
@@ -15382,13 +15349,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/BulkDeleteInput"
-  /{zone}/collection/{collectionId}/app/{appId}/records/bulk-upsert:
-    post:
+              $ref: "#/components/schemas/CaseSummaryRequest"
+  /{zone}/collection/{collectionId}/app/{appId}/cases/{caseId}:
+    get:
       tags:
-        - records
-      summary: Upsert up to 500 records in a single transaction.
-      operationId: records_bulkUpsert
+        - cases
+      summary: "Get a single case by ID GET /cases/:caseId"
+      operationId: cases_get
       security: []
       parameters:
         - name: zone
@@ -15406,33 +15373,29 @@ paths:
           required: true
           schema:
             type: string
+        - name: caseId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/BulkUpsertResult"
+                $ref: "#/components/schemas/AppCase"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: array
-              items:
-                $ref: "#/components/schemas/BulkUpsertItem"
-  /{zone}/collection/{collectionId}/app/{appId}/records/match:
-    post:
+    patch:
       tags:
-        - records
-      summary: Match records against a runtime target scope.
-      operationId: records_match
+        - cases
+      summary: "Update a case PATCH /cases/:caseId Admin can update any field, public (owner) can only update data and owner zones"
+      operationId: cases_update
       security: []
       parameters:
         - name: zone
@@ -15450,13 +15413,18 @@ paths:
           required: true
           schema:
             type: string
+        - name: caseId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/MatchResult"
+                $ref: "#/components/schemas/AppCase"
         400:
           description: Bad request
         401:
@@ -15468,13 +15436,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/MatchRecordsInput"
-  /{zone}/collection/{collectionId}/app/{appId}/records/preview-rule:
+              $ref: "#/components/schemas/UpdateCaseInput"
+  /{zone}/collection/{collectionId}/app/{appId}/cases/{caseId}/history:
     post:
       tags:
-        - records
-      summary: Preview which products in the collection match a given facetRule.
-      operationId: records_previewRule
+        - cases
+      summary: "Append an entry to case history (admin only) POST /cases/:caseId/history"
+      operationId: cases_appendHistory
       security: []
       parameters:
         - name: zone
@@ -15492,13 +15460,18 @@ paths:
           required: true
           schema:
             type: string
+        - name: caseId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PreviewRuleResult"
+                $ref: "#/components/schemas/AppCase"
         400:
           description: Bad request
         401:
@@ -15510,13 +15483,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/PreviewRuleParams"
-  /{zone}/collection/{collectionId}/app/{appId}/records/resolve-all:
-    post:
+              $ref: "#/components/schemas/AppendHistoryInput"
+  /{zone}/collection/{collectionId}/app/{appId}/cases/{caseId}/related:
+    get:
       tags:
-        - records
-      summary: Resolve every applicable record for a product context in one call.
-      operationId: records_resolveAll
+        - cases
+      summary: "Get related threads and records for a case (admin only) GET /cases/:caseId/related"
+      operationId: cases_related
       security: []
       parameters:
         - name: zone
@@ -15534,44 +15507,7 @@ paths:
           required: true
           schema:
             type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ResolveAllResult"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/ResolveAllParams"
-  /{zone}/collection/{collectionId}/app/{appId}/records/upsert:
-    post:
-      tags:
-        - records
-      summary: Upsert a record by ref — creates if no record with that ref exists, otherwise updates.
-      operationId: records_upsert
-      security: []
-      parameters:
-        - name: zone
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: appId
+        - name: caseId
           in: path
           required: true
           schema:
@@ -15582,25 +15518,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/UpsertRecordResponse"
+                $ref: "#/components/schemas/RelatedResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/UpsertRecordInput"
-  /{zone}/collection/{collectionId}/app/{appId}/records/{recordId}:
+  /{zone}/collection/{collectionId}/app/{appId}/records:
     get:
       tags:
         - records
-      summary: "Get a single record by ID GET /records/:recordId"
-      operationId: records_get
+      summary: "List records with optional query parameters GET /records Public/owner callers only receive records with `status: \"active\"`."
+      operationId: records_list
       security: []
       parameters:
         - name: zone
@@ -15618,139 +15548,71 @@ paths:
           required: true
           schema:
             type: string
-        - name: recordId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/AppRecord"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-    patch:
-      tags:
-        - records
-      summary: "Update a record PATCH /records/:recordId Admin can update any field, public (owner) can only update data and owner"
-      operationId: records_update
-      security: []
-      parameters:
-        - name: zone
-          in: path
-          required: true
+        - name: status
+          in: query
+          required: false
           schema:
             type: string
-        - name: collectionId
-          in: path
-          required: true
+        - name: recordType
+          in: query
+          required: false
           schema:
             type: string
-        - name: appId
-          in: path
-          required: true
+        - name: ref
+          in: query
+          required: false
           schema:
             type: string
-        - name: recordId
-          in: path
-          required: true
+        - name: refPrefix
+          in: query
+          required: false
           schema:
             type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/AppRecord"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/UpdateRecordInput"
-  /{zone}/collection/{collectionId}/app/{appId}/records/{recordId}/restore:
-    post:
-      tags:
-        - records
-      summary: Restore a soft-deleted record.
-      operationId: records_restore
-      security: []
-      parameters:
-        - name: zone
-          in: path
-          required: true
+        - name: customId
+          in: query
+          required: false
           schema:
             type: string
-        - name: collectionId
-          in: path
-          required: true
+        - name: sourceSystem
+          in: query
+          required: false
           schema:
             type: string
-        - name: appId
-          in: path
-          required: true
+        - name: proofId
+          in: query
+          required: false
           schema:
             type: string
-        - name: recordId
-          in: path
-          required: true
+        - name: variantId
+          in: query
+          required: false
           schema:
             type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/AppRecord"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /{zone}/collection/{collectionId}/app/{appId}/threads:
-    get:
-      tags:
-        - threads
-      summary: List threads with optional query parameters GET /threads
-      operationId: threads_list
-      security: []
-      parameters:
-        - name: zone
-          in: path
-          required: true
+        - name: batchId
+          in: query
+          required: false
           schema:
             type: string
-        - name: collectionId
-          in: path
-          required: true
+        - name: q
+          in: query
+          required: false
           schema:
             type: string
-        - name: appId
-          in: path
-          required: true
+        - name: qFields
+          in: query
+          required: false
           schema:
             type: string
-        - name: slug
+        - name: dataFilter
           in: query
           required: false
           schema:
-            type: string
+            type: object
+            additionalProperties:
+              type: array
+              items:
+                type: object
+                additionalProperties: true
         - name: authorId
           in: query
           required: false
@@ -15766,24 +15628,27 @@ paths:
           required: false
           schema:
             type: string
-        - name: parentIds
+        - name: startsAt
           in: query
           required: false
           schema:
-            type: array
-            items:
-              type: string
-        - name: proofId
+            type: string
+        - name: expiresAt
           in: query
           required: false
           schema:
             type: string
-        - name: productId
+        - name: includeScheduled
           in: query
           required: false
           schema:
-            type: string
-        - name: tag
+            type: boolean
+        - name: includeExpired
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: at
           in: query
           required: false
           schema:
@@ -15793,6 +15658,11 @@ paths:
           required: false
           schema:
             type: string
+        - name: includeDeleted
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -15809,9 +15679,9 @@ paths:
           description: Not found
     post:
       tags:
-        - threads
-      summary: Create a new thread POST /threads
-      operationId: threads_create
+        - records
+      summary: "Create a new record POST /records When called on the public endpoint (admin = false) with an anonymous caller, and the app's `publicCreate.records.anonymous.edit.editToken` policy is enabled, the response includes a one-time `editToken` string."
+      operationId: records_create
       security: []
       parameters:
         - name: zone
@@ -15835,7 +15705,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppThread"
+                $ref: "#/components/schemas/CreateRecordResponse"
         400:
           description: Bad request
         401:
@@ -15847,13 +15717,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateThreadInput"
-  /{zone}/collection/{collectionId}/app/{appId}/threads/aggregate:
+              $ref: "#/components/schemas/CreateRecordInput"
+  /{zone}/collection/{collectionId}/app/{appId}/records/aggregate:
     post:
       tags:
-        - threads
-      summary: Get aggregate statistics for threads POST /threads/aggregate
-      operationId: threads_aggregate
+        - records
+      summary: Get aggregate statistics for records POST /records/aggregate
+      operationId: records_aggregate
       security: []
       parameters:
         - name: zone
@@ -15890,12 +15760,12 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/AggregateRequest"
-  /{zone}/collection/{collectionId}/app/{appId}/threads/{threadId}:
-    get:
+  /{zone}/collection/{collectionId}/app/{appId}/records/bulk-delete:
+    post:
       tags:
-        - threads
-      summary: "Get a single thread by ID GET /threads/:threadId"
-      operationId: threads_get
+        - records
+      summary: Soft-delete records in bulk.
+      operationId: records_bulkDelete
       security: []
       parameters:
         - name: zone
@@ -15913,7 +15783,44 @@ paths:
           required: true
           schema:
             type: string
-        - name: threadId
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/BulkDeleteResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/BulkDeleteInput"
+  /{zone}/collection/{collectionId}/app/{appId}/records/bulk-upsert:
+    post:
+      tags:
+        - records
+      summary: Upsert up to 500 records in a single transaction.
+      operationId: records_bulkUpsert
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
           in: path
           required: true
           schema:
@@ -15924,18 +15831,27 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppThread"
+                $ref: "#/components/schemas/BulkUpsertResult"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    patch:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: array
+              items:
+                $ref: "#/components/schemas/BulkUpsertItem"
+  /{zone}/collection/{collectionId}/app/{appId}/records/match:
+    post:
       tags:
-        - threads
-      summary: "Update a thread PATCH /threads/:threadId Admin can update any field, public (owner) can only update body, tags, data, ow"
-      operationId: threads_update
+        - records
+      summary: Match records against a runtime target scope.
+      operationId: records_match
       security: []
       parameters:
         - name: zone
@@ -15953,7 +15869,44 @@ paths:
           required: true
           schema:
             type: string
-        - name: threadId
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MatchResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/MatchRecordsInput"
+  /{zone}/collection/{collectionId}/app/{appId}/records/preview-rule:
+    post:
+      tags:
+        - records
+      summary: Preview which products in the collection match a given facetRule.
+      operationId: records_previewRule
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
           in: path
           required: true
           schema:
@@ -15964,7 +15917,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppThread"
+                $ref: "#/components/schemas/PreviewRuleResult"
         400:
           description: Bad request
         401:
@@ -15976,13 +15929,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/UpdateThreadInput"
-  /{zone}/collection/{collectionId}/app/{appId}/threads/{threadId}/reply:
+              $ref: "#/components/schemas/PreviewRuleParams"
+  /{zone}/collection/{collectionId}/app/{appId}/records/resolve-all:
     post:
       tags:
-        - threads
-      summary: "Add a reply to a thread POST /threads/:threadId/reply Atomically appends to replies array, increments replyCount, update"
-      operationId: threads_reply
+        - records
+      summary: Resolve every applicable record for a product context in one call.
+      operationId: records_resolveAll
       security: []
       parameters:
         - name: zone
@@ -16000,7 +15953,44 @@ paths:
           required: true
           schema:
             type: string
-        - name: threadId
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ResolveAllResult"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ResolveAllParams"
+  /{zone}/collection/{collectionId}/app/{appId}/records/upsert:
+    post:
+      tags:
+        - records
+      summary: Upsert a record by ref — creates if no record with that ref exists, otherwise updates.
+      operationId: records_upsert
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
           in: path
           required: true
           schema:
@@ -16011,7 +16001,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppThread"
+                $ref: "#/components/schemas/UpsertRecordResponse"
         400:
           description: Bad request
         401:
@@ -16023,13 +16013,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/ReplyInput"
-  /{zone}/collection/{collectionId}/app/{appId}/threads/{threadId}/reply/{replyId}:
-    delete:
+              $ref: "#/components/schemas/UpsertRecordInput"
+  /{zone}/collection/{collectionId}/app/{appId}/records/{recordId}:
+    get:
       tags:
-        - threads
-      summary: Delete a single reply from a thread by its reply id (moderation).
-      operationId: threads_deleteReply
+        - records
+      summary: "Get a single record by ID GET /records/:recordId"
+      operationId: records_get
       security: []
       parameters:
         - name: zone
@@ -16047,12 +16037,47 @@ paths:
           required: true
           schema:
             type: string
-        - name: threadId
+        - name: recordId
           in: path
           required: true
           schema:
             type: string
-        - name: replyId
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppRecord"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    patch:
+      tags:
+        - records
+      summary: "Update a record PATCH /records/:recordId Admin can update any field, public (owner) can only update data and owner"
+      operationId: records_update
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: recordId
           in: path
           required: true
           schema:
@@ -16063,58 +16088,452 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AppThread"
+                $ref: "#/components/schemas/AppRecord"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-components:
-  securitySchemes:
-    bearerAuth:
-      type: http
-      scheme: bearer
-      bearerFormat: JWT
-      description: Bearer token obtained from auth.login() or auth.verifyToken()
-    apiKey:
-      type: apiKey
-      in: header
-      name: X-API-Key
-      description: API key for server-to-server calls
-  schemas:
-    AdminCardRefresh:
-      type: object
-      properties:
-        on:
-          type: array
-          items:
-            $ref: "#/components/schemas/AdminCardRefreshOn"
-        maxAge:
-          type: object
-          additionalProperties: true
-    AdminCardDeclaration:
-      type: object
-      properties:
-        id:
-          type: string
-        title:
-          type: string
-        description:
-          type: string
-        kind:
-          type: string
-          enum:
-            - data
-            - component
-        function:
-          type: string
-        component:
-          type: string
-        sizes:
-          type: array
-          items:
-            $ref: "#/components/schemas/AdminCardSize"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateRecordInput"
+  /{zone}/collection/{collectionId}/app/{appId}/records/{recordId}/restore:
+    post:
+      tags:
+        - records
+      summary: Restore a soft-deleted record.
+      operationId: records_restore
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: recordId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppRecord"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /{zone}/collection/{collectionId}/app/{appId}/threads:
+    get:
+      tags:
+        - threads
+      summary: List threads with optional query parameters GET /threads
+      operationId: threads_list
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: slug
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: authorId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: parentType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: parentId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: parentIds
+          in: query
+          required: false
+          schema:
+            type: array
+            items:
+              type: string
+        - name: proofId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: productId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: tag
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: contactId
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: object
+                additionalProperties: true
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    post:
+      tags:
+        - threads
+      summary: Create a new thread POST /threads
+      operationId: threads_create
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppThread"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateThreadInput"
+  /{zone}/collection/{collectionId}/app/{appId}/threads/aggregate:
+    post:
+      tags:
+        - threads
+      summary: Get aggregate statistics for threads POST /threads/aggregate
+      operationId: threads_aggregate
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AggregateResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AggregateRequest"
+  /{zone}/collection/{collectionId}/app/{appId}/threads/{threadId}:
+    get:
+      tags:
+        - threads
+      summary: "Get a single thread by ID GET /threads/:threadId"
+      operationId: threads_get
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: threadId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppThread"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    patch:
+      tags:
+        - threads
+      summary: "Update a thread PATCH /threads/:threadId Admin can update any field, public (owner) can only update body, tags, data, ow"
+      operationId: threads_update
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: threadId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppThread"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateThreadInput"
+  /{zone}/collection/{collectionId}/app/{appId}/threads/{threadId}/reply:
+    post:
+      tags:
+        - threads
+      summary: "Add a reply to a thread POST /threads/:threadId/reply Atomically appends to replies array, increments replyCount, update"
+      operationId: threads_reply
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: threadId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppThread"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ReplyInput"
+  /{zone}/collection/{collectionId}/app/{appId}/threads/{threadId}/reply/{replyId}:
+    delete:
+      tags:
+        - threads
+      summary: Delete a single reply from a thread by its reply id (moderation).
+      operationId: threads_deleteReply
+      security: []
+      parameters:
+        - name: zone
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: threadId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: replyId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AppThread"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+components:
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: Bearer token obtained from auth.login() or auth.verifyToken()
+    apiKey:
+      type: apiKey
+      in: header
+      name: X-API-Key
+      description: API key for server-to-server calls
+  schemas:
+    AdminCardRefresh:
+      type: object
+      properties:
+        on:
+          type: array
+          items:
+            $ref: "#/components/schemas/AdminCardRefreshOn"
+        maxAge:
+          type: object
+          additionalProperties: true
+    AdminCardDeclaration:
+      type: object
+      properties:
+        id:
+          type: string
+        title:
+          type: string
+        description:
+          type: string
+        kind:
+          type: string
+          enum:
+            - data
+            - component
+        function:
+          type: string
+        component:
+          type: string
+        sizes:
+          type: array
+          items:
+            $ref: "#/components/schemas/AdminCardSize"
         priority:
           type: number
         levels:
@@ -25168,82 +25587,417 @@ components:
     BroadcastAppendEventBody:
       type: object
       properties:
-        broadcastId:
+        broadcastId:
+          type: string
+        contactId:
+          type: string
+        channel:
+          $ref: "#/components/schemas/BroadcastChannel"
+        templateId:
+          type: string
+        eventType:
+          type: string
+        outcome:
+          type: string
+          enum:
+            - success
+            - failed
+        failureReason:
+          type: string
+        metadata:
+          type: object
+          additionalProperties: true
+      required:
+        - broadcastId
+        - eventType
+    BroadcastAppendBulkBody:
+      type: object
+      properties:
+        ids:
+          type: array
+          items:
+            type: string
+        idField:
+          type: string
+        params:
+          type: object
+          additionalProperties: true
+      required:
+        - ids
+        - params
+    BroadcastChannel:
+      type: string
+      enum:
+        - email
+        - push
+        - sms
+        - wallet
+    BroadcastPreviewResponse:
+      type: object
+      additionalProperties: true
+    ClaimCodeRef:
+      type: object
+      properties:
+        codeId:
+          type: string
+        claimId:
+          type: string
+      required:
+        - codeId
+        - claimId
+    UpdateClaimDataRequest:
+      type: object
+      properties:
+        data:
+          type: object
+          additionalProperties: true
+        codes:
+          type: array
+          items:
+            $ref: "#/components/schemas/ClaimCodeRef"
+      required:
+        - data
+        - codes
+    AssignClaimsRequest:
+      type: object
+      properties:
+        id:
+          type: string
+        collectionId:
+          type: string
+        productId:
+          type: string
+        batchId:
+          type: string
+        start:
+          type: number
+        end:
+          type: number
+        codeId:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+        - collectionId
+        - productId
+    CreateClaimSetTagRequest:
+      type: object
+      properties:
+        id:
+          type: string
+        tagId:
+          type: string
+        productId:
+          type: string
+        collectionId:
+          type: string
+        batchId:
+          type: string
+        password:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+    CreateClaimSetRequest:
+      type: object
+      properties:
+        name:
+          type: string
+        claimMode:
+          type: string
+        allocationMode:
+          type: string
+      required:
+        - name
+        - claimMode
+        - allocationMode
+    ImportClaimSetTagItem:
+      type: object
+      properties:
+        id:
+          type: string
+        tagId:
+          type: string
+        index:
+          type: number
+      required:
+        - id
+    ImportClaimSetTagsRequest:
+      type: object
+      properties:
+        tags:
+          type: array
+          items:
+            $ref: "#/components/schemas/ImportClaimSetTagItem"
+        mode:
+          type: string
+          enum:
+            - upsert
+            - replace
+      required:
+        - tags
+    ImportClaimSetTagsResponse:
+      type: object
+      properties:
+        written:
+          type: number
+      required:
+        - written
+    CreateClaimSetTagResponse:
+      type: object
+      properties:
+        id:
+          type: string
+        claimSetId:
+          type: string
+        createdAt:
+          type: string
+        tagId:
+          type: string
+        productId:
+          type: string
+        collectionId:
+          type: string
+        batchId:
+          type: string
+        password:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+        - claimSetId
+        - createdAt
+    ClaimSetRange:
+      type: object
+      properties:
+        id:
+          type: string
+        claimSetId:
+          type: string
+        namespace:
+          type: string
+        name:
+          type: string
+        notes:
+          type: string
+        startIndex:
+          type: number
+        endIndex:
+          type: number
+        quantity:
+          type: number
+        tagType:
+          $ref: "#/components/schemas/ClaimSetTagType"
+        fulfilment:
+          type: string
+          enum:
+            - printer
+            - sidekick
+        stage:
+          type: string
+          enum:
+            - minting
+            - minted
+            - sent
+            - received
+        status:
+          $ref: "#/components/schemas/ClaimSetRangeStatus"
+        intendedCollectionId:
+          type: string
+        intendedProductId:
+          type: string
+        intendedBatchId:
+          type: string
+        manufacturer:
+          type: string
+        orderRef:
+          type: string
+        counts:
+          type: object
+          additionalProperties: true
+        sentAt:
+          type: string
+        receivedAt:
+          type: string
+        createdBy:
+          type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+      required:
+        - id
+        - claimSetId
+        - namespace
+        - name
+        - notes
+        - startIndex
+        - endIndex
+        - quantity
+        - tagType
+        - fulfilment
+        - stage
+        - status
+        - intendedCollectionId
+        - intendedProductId
+        - intendedBatchId
+        - manufacturer
+        - orderRef
+        - counts
+        - sentAt
+        - receivedAt
+        - createdBy
+        - createdAt
+        - updatedAt
+    CreateClaimSetRangeRequest:
+      type: object
+      properties:
+        name:
+          type: string
+        quantity:
+          type: number
+        intendedCollectionId:
+          type: string
+        intendedProductId:
+          type: string
+        intendedBatchId:
+          type: string
+        fulfilment:
+          type: string
+          enum:
+            - printer
+            - sidekick
+        notes:
+          type: string
+        manufacturer:
+          type: string
+        orderRef:
+          type: string
+      required:
+        - name
+        - quantity
+    UpdateClaimSetRangeRequest:
+      type: object
+      properties:
+        name:
           type: string
-        contactId:
+        notes:
           type: string
-        channel:
-          $ref: "#/components/schemas/BroadcastChannel"
-        templateId:
+        manufacturer:
           type: string
-        eventType:
+        orderRef:
           type: string
-        outcome:
+        fulfilment:
           type: string
           enum:
-            - success
-            - failed
-        failureReason:
+            - printer
+            - sidekick
+        stage:
           type: string
-        metadata:
-          type: object
-          additionalProperties: true
+          enum:
+            - minted
+            - sent
+            - received
+    ClaimSetRangeTag:
+      type: object
+      properties:
+        code:
+          type: string
+        printed:
+          type: string
+        index:
+          type: number
+        uid:
+          type: string
+        key:
+          type: string
+        collectionId:
+          type: string
+        productId:
+          type: string
+        batchId:
+          type: string
+        proofId:
+          type: string
+        programmedAt:
+          type: string
+        scans:
+          type: number
       required:
-        - broadcastId
-        - eventType
-    BroadcastAppendBulkBody:
+        - code
+        - printed
+        - index
+        - uid
+        - collectionId
+        - productId
+        - batchId
+        - proofId
+        - programmedAt
+        - scans
+    ClaimSetRangeTagsPage:
       type: object
       properties:
-        ids:
+        tags:
           type: array
           items:
-            type: string
-        idField:
-          type: string
-        params:
-          type: object
-          additionalProperties: true
+            $ref: "#/components/schemas/ClaimSetRangeTag"
+        next:
+          type: number
       required:
-        - ids
-        - params
-    BroadcastChannel:
-      type: string
-      enum:
-        - email
-        - push
-        - sms
-        - wallet
-    BroadcastPreviewResponse:
-      type: object
-      additionalProperties: true
-    ClaimCodeRef:
+        - tags
+        - next
+    ClaimSetRangeNextTag:
       type: object
       properties:
-        codeId:
-          type: string
-        claimId:
+        url:
           type: string
+        piccOffset:
+          type: number
+        mirrorOffset:
+          type: number
+        remaining:
+          type: number
       required:
-        - codeId
-        - claimId
-    UpdateClaimDataRequest:
+        - url
+        - remaining
+    ImportClaimSetRangeUidsRequest:
       type: object
       properties:
-        data:
+        csv:
+          type: string
+        rows:
+          type: array
+          items:
+            type: object
+            additionalProperties:
+              type: object
+              additionalProperties: true
+        commit:
+          type: boolean
+    ImportClaimSetRangeUidsResponse:
+      type: object
+      properties:
+        summary:
           type: object
           additionalProperties: true
-        codes:
+        rows:
           type: array
           items:
-            $ref: "#/components/schemas/ClaimCodeRef"
+            type: object
+            additionalProperties: true
+        range:
+          $ref: "#/components/schemas/ClaimSetRange"
       required:
-        - data
-        - codes
-    AssignClaimsRequest:
+        - summary
+        - rows
+        - range
+    AssignClaimSetRangeRequest:
       type: object
       properties:
-        id:
-          type: string
         collectionId:
           type: string
         productId:
@@ -25254,104 +26008,164 @@ components:
           type: number
         end:
           type: number
-        codeId:
-          type: string
+        clear:
+          type: boolean
         data:
           type: object
           additionalProperties: true
+    AssignClaimSetRangeResponse:
+      type: object
+      properties:
+        changed:
+          type: number
+        skipped:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        range:
+          $ref: "#/components/schemas/ClaimSetRange"
       required:
-        - id
-        - collectionId
-        - productId
-    CreateClaimSetTagRequest:
+        - changed
+        - skipped
+        - range
+    ClaimSetRangeFile:
       type: object
       properties:
-        id:
-          type: string
-        tagId:
+        filename:
           type: string
-        productId:
+        contentType:
           type: string
-        collectionId:
+        csv:
           type: string
-        batchId:
+        base64:
           type: string
-        password:
+        markdown:
           type: string
-        data:
-          type: object
-          additionalProperties: true
-    CreateClaimSetRequest:
+      required:
+        - filename
+        - contentType
+    Partner:
       type: object
       properties:
+        id:
+          type: string
         name:
           type: string
-        claimMode:
+        status:
           type: string
-        allocationMode:
+          enum:
+            - active
+            - suspended
+        tapDomains:
+          type: array
+          items:
+            type: string
+        features:
+          type: object
+          additionalProperties:
+            type: boolean
+        role:
+          type: string
+          enum:
+            - owner
+            - admin
+            - assigner
+        members:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        createdAt:
+          type: string
+        updatedAt:
           type: string
       required:
+        - id
         - name
-        - claimMode
-        - allocationMode
-    ImportClaimSetTagItem:
+        - status
+        - tapDomains
+        - features
+        - createdAt
+        - updatedAt
+    PartnerClaimSet:
       type: object
       properties:
         id:
           type: string
-        tagId:
+        namespace:
           type: string
-        index:
+        name:
+          type: string
+        tagType:
+          $ref: "#/components/schemas/ClaimSetTagType"
+        tapDomain:
+          type: string
+        owner:
+          type: object
+          additionalProperties: true
+        codes:
           type: number
+        deleted:
+          type: boolean
+        createdAt:
+          type: string
       required:
         - id
-    ImportClaimSetTagsRequest:
+        - namespace
+        - name
+        - tagType
+        - tapDomain
+        - owner
+        - codes
+        - deleted
+        - createdAt
+    CreatePartnerClaimSetRequest:
       type: object
       properties:
-        tags:
-          type: array
-          items:
-            $ref: "#/components/schemas/ImportClaimSetTagItem"
-        mode:
+        name:
+          type: string
+        tagType:
+          $ref: "#/components/schemas/ClaimSetTagType"
+        tapDomain:
           type: string
-          enum:
-            - upsert
-            - replace
-      required:
-        - tags
-    ImportClaimSetTagsResponse:
-      type: object
-      properties:
-        written:
-          type: number
       required:
-        - written
-    CreateClaimSetTagResponse:
+        - name
+        - tagType
+    ClaimSetScope:
       type: object
       properties:
-        id:
-          type: string
-        claimSetId:
-          type: string
-        createdAt:
-          type: string
-        tagId:
-          type: string
-        productId:
-          type: string
         collectionId:
           type: string
-        batchId:
-          type: string
-        password:
-          type: string
-        data:
-          type: object
-          additionalProperties: true
       required:
-        - id
-        - claimSetId
-        - createdAt
+        - collectionId
+    ClaimSetTagType:
+      type: string
+      enum:
+        - ntag424
+        - ntag21x
+        - qr
+    ClaimSetRangeStatus:
+      type: string
+      enum:
+        - minting
+        - minted
+        - sent
+        - received
+        - assigned
+    ClaimSetImportResult:
+      type: string
+      enum:
+        - ok
+        - unchanged
+        - unknown_code
+        - duplicate_row
+        - index_mismatch
+        - no_uid
+        - bad_uid
+        - duplicate_uid
+        - uid_in_use
+        - uid_conflict
     Collection:
       type: object
       properties: