@proveanything/smartlinks 1.9.4 → 1.9.5

package/dist/openapi.yaml

@@ -106,115 +106,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/CollectionCreateRequest"
-  /admin/collection//async/jobs:
-    post:
-      tags:
-        - async
-      summary: "Enqueue a background job for a collection POST /admin/collection/:collectionId/async/jobs (202)"
-      operationId: async_enqueueAsyncJob
-      security:
-        - bearerAuth: []
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/EnqueueAsyncJobResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/EnqueueAsyncJobRequest"
-  /admin/collection//async/jobs/{jobId}:
-    get:
-      tags:
-        - async
-      summary: "Enqueue a background job for a collection POST /admin/collection/:collectionId/async/jobs (202) / export async function"
-      operationId: async_getAsyncJobStatus
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: jobId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Job"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection//jobs/{jobId}:
-    get:
-      tags:
-        - jobs
-      summary: "List visible jobs for a collection GET /admin/collection/:collectionId/jobs / export async function listJobs( collection"
-      operationId: jobs_getJob
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: jobId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Job"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection//jobs{qs}:
-    get:
-      tags:
-        - jobs
-      summary: "List visible jobs for a collection GET /admin/collection/:collectionId/jobs"
-      operationId: jobs_listJobs
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/JobsPage"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection//product//batch/{batchId}:
+  /admin/collection/product/batch/{batchId}:
     get:
       tags:
         - batch
@@ -300,7 +192,7 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection//product//variant/{variantId}:
+  /admin/collection/product/variant/{variantId}:
     get:
       tags:
         - variant
@@ -386,7 +278,7 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection//product/{productId}/batch:
+  /admin/collection/product/{productId}/batch:
     get:
       tags:
         - batch
@@ -447,7 +339,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/BatchCreateRequest"
-  /admin/collection//product/{productId}/variant:
+  /admin/collection/product/{productId}/variant:
     get:
       tags:
         - variant
@@ -739,6 +631,24 @@ paths:
           required: true
           schema:
             type: string
+        - name: provider
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - gemini
+              - openai
+        - name: capability
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - text
+              - vision
+              - audio
+              - code
       responses:
         200:
           description: Success
@@ -1034,12 +944,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/attestations:
+  /admin/collection/{collectionId}/async/jobs:
     post:
       tags:
-        - attestations
-      summary: Create a single attestation (admin).
-      operationId: attestations_create
+        - async
+      summary: "Enqueue a background job for a collection POST /admin/collection/:collectionId/async/jobs (202)"
+      operationId: async_enqueueAsyncJob
       security:
         - bearerAuth: []
       parameters:
@@ -1054,7 +964,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Attestation"
+                $ref: "#/components/schemas/EnqueueAsyncJobResponse"
         400:
           description: Bad request
         401:
@@ -1066,13 +976,13 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateAttestationInput"
-  /admin/collection/{collectionId}/attestations/latest{qs}:
+              $ref: "#/components/schemas/EnqueueAsyncJobRequest"
+  /admin/collection/{collectionId}/async/jobs/{jobId}:
     get:
       tags:
-        - attestations
-      summary: "Latest snapshot — one record per `attestationType` (admin)."
-      operationId: attestations_latest
+        - async
+      summary: "Enqueue a background job for a collection POST /admin/collection/:collectionId/async/jobs (202) / export async function"
+      operationId: async_getAsyncJobStatus
       security:
         - bearerAuth: []
       parameters:
@@ -1081,7 +991,7 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
+        - name: jobId
           in: path
           required: true
           schema:
@@ -1092,19 +1002,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AttestationLatestResponse"
+                $ref: "#/components/schemas/Job"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/attestations/summary{qs}:
+  /admin/collection/{collectionId}/attestations:
     get:
       tags:
         - attestations
-      summary: Time-series summary of attestations (admin).
-      operationId: attestations_summary
+      summary: List attestations for a subject (admin).
+      operationId: attestations_list
       security:
         - bearerAuth: []
       parameters:
@@ -1113,30 +1023,59 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AttestationSummaryResponse"
+                $ref: "#/components/schemas/ListAttestationsResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/attestations/tree-latest{qs}:
-    get:
+    post:
       tags:
         - attestations
-      summary: Tree latest snapshot — most-recent record per type across a container subtree (admin).
-      operationId: attestations_treeLatest
+      summary: Create a single attestation (admin).
+      operationId: attestations_create
       security:
         - bearerAuth: []
       parameters:
@@ -1145,30 +1084,31 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AttestationTreeLatestResponse"
+                $ref: "#/components/schemas/Attestation"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/attestations/tree-summary{qs}:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateAttestationInput"
+  /admin/collection/{collectionId}/attestations/latest:
     get:
       tags:
         - attestations
-      summary: Tree time-series summary — aggregates across an entire container subtree (admin).
-      operationId: attestations_treeSummary
+      summary: "Latest snapshot — one record per `attestationType` (admin)."
+      operationId: attestations_latest
       security:
         - bearerAuth: []
       parameters:
@@ -1177,9 +1117,14 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
       responses:
@@ -1188,19 +1133,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AttestationTreeSummaryResponse"
+                $ref: "#/components/schemas/AttestationLatestResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/attestations/verify{qs}:
+  /admin/collection/{collectionId}/attestations/summary:
     get:
       tags:
         - attestations
-      summary: "Verify the hash chain for a `(subjectType, subjectId, attestationType)` tuple (admin)."
-      operationId: attestations_verify
+      summary: Time-series summary of attestations (admin).
+      operationId: attestations_summary
       security:
         - bearerAuth: []
       parameters:
@@ -1209,30 +1154,65 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: valueField
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationGroupBy"
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ChainVerifyResult"
+                $ref: "#/components/schemas/AttestationSummaryResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/attestations{qs}:
+  /admin/collection/{collectionId}/attestations/tree-latest:
     get:
       tags:
         - attestations
-      summary: List attestations for a subject (admin).
-      operationId: attestations_list
+      summary: Tree latest snapshot — most-recent record per type across a container subtree (admin).
+      operationId: attestations_treeLatest
       security:
         - bearerAuth: []
       parameters:
@@ -1241,18 +1221,132 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListAttestationsResponse"
+                $ref: "#/components/schemas/AttestationTreeLatestResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/attestations/tree-summary:
+    get:
+      tags:
+        - attestations
+      summary: Tree time-series summary — aggregates across an entire container subtree (admin).
+      operationId: attestations_treeSummary
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: valueField
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationGroupBy"
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AttestationTreeSummaryResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /admin/collection/{collectionId}/attestations/verify:
+    get:
+      tags:
+        - attestations
+      summary: "Verify the hash chain for a `(subjectType, subjectId, attestationType)` tuple (admin)."
+      operationId: attestations_verify
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ChainVerifyResult"
         400:
           description: Bad request
         401:
@@ -1395,6 +1489,21 @@ paths:
           required: true
           schema:
             type: string
+        - name: search
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: productId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
@@ -1490,6 +1599,21 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: appId
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -1744,7 +1868,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/BroadcastPreviewRequest"
-  /admin/collection/{collectionId}/broadcasts/{id}/recipients{qs}:
+  /admin/collection/{collectionId}/broadcasts/{id}/recipients:
     get:
       tags:
         - broadcasts
@@ -1763,11 +1887,6 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
       responses:
         200:
           description: Success
@@ -1935,7 +2054,7 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet//assignClaims:
+  /admin/collection/{collectionId}/claimSet/assignClaims:
     post:
       tags:
         - claimSet
@@ -1967,7 +2086,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/AssignClaimsRequest"
-  /admin/collection/{collectionId}/claimSet//makeClaim:
+  /admin/collection/{collectionId}/claimSet/makeClaim:
     post:
       tags:
         - claimSet
@@ -2237,11 +2356,11 @@ paths:
             schema:
               $ref: "#/components/schemas/TransactionalSendRequest"
   /admin/collection/{collectionId}/comm.settings:
-    patch:
+    get:
       tags:
         - comms
-      summary: "Admin: Get current comms settings for a collection."
-      operationId: comms_patchSettings
+      summary: "Public: Register a Web Push subscription under unified comms."
+      operationId: comms_getSettings
       security:
         - bearerAuth: []
       parameters:
@@ -2250,6 +2369,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeSecret
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -2264,19 +2388,11 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              additionalProperties: true
-  /admin/collection/{collectionId}/comm.settings{qs}:
-    get:
+    patch:
       tags:
         - comms
-      summary: "Public: Register a Web Push subscription under unified comms."
-      operationId: comms_getSettings
+      summary: "Admin: Get current comms settings for a collection."
+      operationId: comms_patchSettings
       security:
         - bearerAuth: []
       parameters:
@@ -2285,16 +2401,6 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: includeSecret
-          in: query
-          required: false
-          schema:
-            type: string
       responses:
         200:
           description: Success
@@ -2309,6 +2415,13 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: true
   /admin/collection/{collectionId}/comm/log:
     post:
       tags:
@@ -2802,6 +2915,67 @@ paths:
         404:
           description: Not found
   /admin/collection/{collectionId}/containers:
+    get:
+      tags:
+        - containers
+      summary: List containers (admin).
+      operationId: containers_list
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: containerType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: status
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/ContainerStatus"
+        - name: ref
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: parentContainerId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: topLevel
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListContainersResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
     post:
       tags:
         - containers
@@ -2834,7 +3008,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/CreateContainerInput"
-  /admin/collection/{collectionId}/containers/find-for-item{qs}:
+  /admin/collection/{collectionId}/containers/find-for-item:
     get:
       tags:
         - containers
@@ -2848,9 +3022,14 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: itemType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/ContainerItemType"
+        - name: itemId
+          in: query
+          required: false
           schema:
             type: string
       responses:
@@ -2867,11 +3046,11 @@ paths:
         404:
           description: Not found
   /admin/collection/{collectionId}/containers/{containerId}:
-    patch:
+    get:
       tags:
         - containers
-      summary: Partially update a container (admin).
-      operationId: containers_update
+      summary: Get a single container by ID (admin).
+      operationId: containers_get
       security:
         - bearerAuth: []
       parameters:
@@ -2885,62 +3064,39 @@ paths:
           required: true
           schema:
             type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/Container"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/UpdateContainerInput"
-  /admin/collection/{collectionId}/containers/{containerId}/items:
-    get:
-      tags:
-        - containers
-      summary: Soft-remove items from a container (admin).
-      operationId: containers_removeItems
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
+        - name: tree
+          in: query
+          required: false
           schema:
-            type: string
-        - name: containerId
-          in: path
-          required: true
+            type: boolean
+        - name: treeDepth
+          in: query
+          required: false
           schema:
-            type: string
+            type: number
+        - name: includeContents
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/RemoveContainerItemsResponse"
+                $ref: "#/components/schemas/Container"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    post:
+    patch:
       tags:
         - containers
-      summary: Add one or more items to a container (admin).
-      operationId: containers_addItems
+      summary: Partially update a container (admin).
+      operationId: containers_update
       security:
         - bearerAuth: []
       parameters:
@@ -2960,7 +3116,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/AddContainerItemsResponse"
+                $ref: "#/components/schemas/Container"
         400:
           description: Bad request
         401:
@@ -2972,8 +3128,8 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/AddContainerItemsInput"
-  /admin/collection/{collectionId}/containers/{containerId}/items{qs}:
+              $ref: "#/components/schemas/UpdateContainerInput"
+  /admin/collection/{collectionId}/containers/{containerId}/items:
     get:
       tags:
         - containers
@@ -2992,67 +3148,39 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ContainerItemsResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection/{collectionId}/containers/{containerId}{qs}:
-    get:
-      tags:
-        - containers
-      summary: Get a single container by ID (admin).
-      operationId: containers_get
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
+        - name: history
+          in: query
+          required: false
           schema:
-            type: string
-        - name: containerId
-          in: path
-          required: true
+            type: boolean
+        - name: limit
+          in: query
+          required: false
           schema:
-            type: string
-        - name: qs
-          in: path
-          required: true
+            type: number
+        - name: offset
+          in: query
+          required: false
           schema:
-            type: string
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Container"
+                $ref: "#/components/schemas/ContainerItemsResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/containers{qs}:
-    get:
+    post:
       tags:
         - containers
-      summary: List containers (admin).
-      operationId: containers_list
+      summary: Add one or more items to a container (admin).
+      operationId: containers_addItems
       security:
         - bearerAuth: []
       parameters:
@@ -3061,7 +3189,7 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
+        - name: containerId
           in: path
           required: true
           schema:
@@ -3072,13 +3200,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ListContainersResponse"
+                $ref: "#/components/schemas/AddContainerItemsResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddContainerItemsInput"
   /admin/collection/{collectionId}/crate:
     get:
       tags:
@@ -3093,6 +3227,21 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: startAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: includeDeleted
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -3252,6 +3401,27 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeValues
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: includeDeleted
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: kind
+          in: query
+          required: false
+          schema:
+            type: object
+            additionalProperties: true
+        - name: reserved
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -3349,6 +3519,16 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeValues
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: includeDeleted
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -3450,6 +3630,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeDeleted
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -3524,6 +3709,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeDeleted
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -3732,6 +3922,47 @@ paths:
         404:
           description: Not found
   /admin/collection/{collectionId}/interactions:
+    get:
+      tags:
+        - interactions
+      summary: interactions.list
+      operationId: interactions_list
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/InteractionTypeList"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
     post:
       tags:
         - interactions
@@ -3968,12 +4199,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/interactions/{qs}:
+  /admin/collection/{collectionId}/jobs:
     get:
       tags:
-        - interactions
-      summary: interactions.list
-      operationId: interactions_list
+        - jobs
+      summary: "List visible jobs for a collection GET /admin/collection/:collectionId/jobs"
+      operationId: jobs_listJobs
       security:
         - bearerAuth: []
       parameters:
@@ -3982,9 +4213,34 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: state
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/JobStatus"
+        - name: task
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: to
+          in: query
+          required: false
           schema:
             type: string
       responses:
@@ -3993,19 +4249,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/InteractionTypeList"
+                $ref: "#/components/schemas/JobsPage"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/journeys:
+  /admin/collection/{collectionId}/jobs/{jobId}:
     get:
       tags:
-        - journeys
-      summary: journeys.list
-      operationId: journeys_list
+        - jobs
+      summary: "List visible jobs for a collection GET /admin/collection/:collectionId/jobs / export async function listJobs( collection"
+      operationId: jobs_getJob
       security:
         - bearerAuth: []
       parameters:
@@ -4014,24 +4270,84 @@ paths:
           required: true
           schema:
             type: string
+        - name: jobId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/JourneyList"
+                $ref: "#/components/schemas/Job"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    post:
+  /admin/collection/{collectionId}/journeys:
+    get:
       tags:
         - journeys
-      summary: journeys.create
-      operationId: journeys_create
+      summary: journeys.list
+      operationId: journeys_list
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: active
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: journeyType
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - event_triggered
+              - scheduled
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JourneyList"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+    post:
+      tags:
+        - journeys
+      summary: journeys.create
+      operationId: journeys_create
       security:
         - bearerAuth: []
       parameters:
@@ -4312,7 +4628,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/LocationPayload"
-  /admin/collection/{collectionId}/location/search{qs}:
+  /admin/collection/{collectionId}/location/search:
     get:
       tags:
         - location
@@ -4326,11 +4642,40 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: q
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: category
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: countryCode
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: countryName
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: sort
+          in: query
+          required: false
           schema:
             type: string
+            enum:
+              - name
+              - countryCode
+              - countryName
       responses:
         200:
           description: Success
@@ -4816,6 +5161,36 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: status
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: orderRef
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: customerId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -5059,6 +5434,16 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
@@ -5124,6 +5509,21 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -5156,6 +5556,21 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: includeOrder
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -5216,6 +5631,66 @@ paths:
           required: true
           schema:
             type: string
+        - name: groupByStatus
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: groupByCollection
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: groupByCustomer
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: groupByDate
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: groupByItemType
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: groupByProduct
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: includeItemStats
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: includeCount
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: topN
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: status
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: createdAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: createdBefore
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -5248,6 +5723,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -5348,6 +5828,16 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
@@ -6616,6 +7106,29 @@ paths:
           required: true
           schema:
             type: string
+        - name: appId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: filterType
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - dynamic
+              - static
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
@@ -6875,6 +7388,41 @@ paths:
           required: true
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: productId
+          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: refType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: refId
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -6967,7 +7515,22 @@ paths:
           required: true
           schema:
             type: string
-      responses:
+        - name: refType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: refId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: embed
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
         200:
           description: Success
           content:
@@ -7281,12 +7844,12 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TemplateRenderRequest"
-  /admin/collection/{collectionId}/translations/{translationId}:
+  /admin/collection/{collectionId}/translations:
     get:
       tags:
         - translations
-      summary: translations.get
-      operationId: translations_get
+      summary: translations.list
+      operationId: translations_list
       security:
         - bearerAuth: []
       parameters:
@@ -7295,29 +7858,65 @@ paths:
           required: true
           schema:
             type: string
-        - name: translationId
-          in: path
-          required: true
+        - name: targetLanguage
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: sourceLanguage
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: contentType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: contextKey
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: q
+          in: query
+          required: false
           schema:
             type: string
+        - name: isOverride
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TranslationRecord"
+                $ref: "#/components/schemas/TranslationListResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-    patch:
+  /admin/collection/{collectionId}/translations/{translationId}:
+    get:
       tags:
         - translations
-      summary: translations.update
-      operationId: translations_update
+      summary: translations.get
+      operationId: translations_get
       security:
         - bearerAuth: []
       parameters:
@@ -7344,18 +7943,11 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/TranslationUpdateRequest"
-  /admin/collection/{collectionId}/translations{query}:
-    get:
+    patch:
       tags:
         - translations
-      summary: translations.list
-      operationId: translations_list
+      summary: translations.update
+      operationId: translations_update
       security:
         - bearerAuth: []
       parameters:
@@ -7364,7 +7956,7 @@ paths:
           required: true
           schema:
             type: string
-        - name: query
+        - name: translationId
           in: path
           required: true
           schema:
@@ -7375,13 +7967,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/TranslationListResponse"
+                $ref: "#/components/schemas/TranslationRecord"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TranslationUpdateRequest"
   /api/admin/auth/push:
     get:
       tags:
@@ -7409,6 +8007,17 @@ paths:
       summary: realtime.getPublicToken
       operationId: realtime_getPublicToken
       security: []
+      parameters:
+        - name: collectionId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: appId
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -8361,15 +8970,15 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection//product//batch/{batchId}:
+  /public/collection/getShortId/{shortId}:
     get:
       tags:
-        - batch
-      summary: Get a single batch by ID for a collection and product (public endpoint).
-      operationId: batch_getPublic
+        - collection
+      summary: Retrieves all Collections.
+      operationId: collection_getShortId
       security: []
       parameters:
-        - name: batchId
+        - name: shortId
           in: path
           required: true
           schema:
@@ -8380,22 +8989,22 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/BatchResponse"
+                $ref: "#/components/schemas/CollectionResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection//product//variant/{variantId}:
+  /public/collection/product/batch/{batchId}:
     get:
       tags:
-        - variant
-      summary: Get a single variant by ID for a collection and product (public endpoint).
-      operationId: variant_getPublic
+        - batch
+      summary: Get a single batch by ID for a collection and product (public endpoint).
+      operationId: batch_getPublic
       security: []
       parameters:
-        - name: variantId
+        - name: batchId
           in: path
           required: true
           schema:
@@ -8406,22 +9015,22 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/VariantResponse"
+                $ref: "#/components/schemas/BatchResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/getShortId/{shortId}:
+  /public/collection/product/variant/{variantId}:
     get:
       tags:
-        - collection
-      summary: Retrieves all Collections.
-      operationId: collection_getShortId
+        - variant
+      summary: Get a single variant by ID for a collection and product (public endpoint).
+      operationId: variant_getPublic
       security: []
       parameters:
-        - name: shortId
+        - name: variantId
           in: path
           required: true
           schema:
@@ -8432,7 +9041,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CollectionResponse"
+                $ref: "#/components/schemas/VariantResponse"
         400:
           description: Bad request
         401:
@@ -8650,12 +9259,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/attestations/latest{qs}:
+  /public/collection/{collectionId}/attestations:
     get:
       tags:
         - attestations
-      summary: "Latest snapshot per `attestationType` (public)."
-      operationId: attestations_publicLatest
+      summary: List attestations for a subject (public).
+      operationId: attestations_publicList
       security: []
       parameters:
         - name: collectionId
@@ -8663,30 +9272,60 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
           schema:
             type: string
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationLatestResponse"
+                $ref: "#/components/schemas/PublicListAttestationsResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/attestations/summary{qs}:
+  /public/collection/{collectionId}/attestations/latest:
     get:
       tags:
         - attestations
-      summary: Time-series summary (public).
-      operationId: attestations_publicSummary
+      summary: "Latest snapshot per `attestationType` (public)."
+      operationId: attestations_publicLatest
       security: []
       parameters:
         - name: collectionId
@@ -8694,9 +9333,14 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
       responses:
@@ -8705,19 +9349,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationSummaryResponse"
+                $ref: "#/components/schemas/PublicAttestationLatestResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/attestations/tree-latest{qs}:
+  /public/collection/{collectionId}/attestations/summary:
     get:
       tags:
         - attestations
-      summary: Tree latest snapshot (public).
-      operationId: attestations_publicTreeLatest
+      summary: Time-series summary (public).
+      operationId: attestations_publicSummary
       security: []
       parameters:
         - name: collectionId
@@ -8725,30 +9369,65 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: valueField
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationGroupBy"
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationTreeLatestResponse"
+                $ref: "#/components/schemas/PublicAttestationSummaryResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/attestations/tree-summary{qs}:
+  /public/collection/{collectionId}/attestations/tree-latest:
     get:
       tags:
         - attestations
-      summary: Tree time-series summary (public).
-      operationId: attestations_publicTreeSummary
+      summary: Tree latest snapshot (public).
+      operationId: attestations_publicTreeLatest
       security: []
       parameters:
         - name: collectionId
@@ -8756,30 +9435,35 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationTreeSummaryResponse"
+                $ref: "#/components/schemas/PublicAttestationTreeLatestResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/attestations{qs}:
+  /public/collection/{collectionId}/attestations/tree-summary:
     get:
       tags:
         - attestations
-      summary: List attestations for a subject (public).
-      operationId: attestations_publicList
+      summary: Tree time-series summary (public).
+      operationId: attestations_publicTreeSummary
       security: []
       parameters:
         - name: collectionId
@@ -8787,18 +9471,53 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: valueField
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationGroupBy"
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicListAttestationsResponse"
+                $ref: "#/components/schemas/PublicAttestationTreeSummaryResponse"
         400:
           description: Bad request
         401:
@@ -8839,7 +9558,7 @@ paths:
             schema:
               type: object
               additionalProperties: true
-  /public/collection/{collectionId}/comm/methods{qs}:
+  /public/collection/{collectionId}/comm/methods:
     get:
       tags:
         - comms
@@ -8852,11 +9571,6 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
         - name: contactId
           in: query
           required: false
@@ -9010,7 +9724,7 @@ paths:
             schema:
               type: object
               additionalProperties: true
-  /public/collection/{collectionId}/comm/subscription/check{qs}:
+  /public/collection/{collectionId}/comm/subscription/check:
     get:
       tags:
         - comms
@@ -9023,11 +9737,6 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
         - name: contactId
           in: query
           required: false
@@ -9123,7 +9832,7 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/comm/unsubscribe{qs}:
+  /public/collection/{collectionId}/comm/unsubscribe:
     get:
       tags:
         - comms
@@ -9136,11 +9845,6 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
         - name: contactId
           in: query
           required: false
@@ -9290,12 +9994,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}/attestations/latest:
+  /public/collection/{collectionId}/containers:
     get:
       tags:
-        - attestations
-      summary: Time-series summary for a specific container (public shortcut).
-      operationId: attestations_publicContainerLatest
+        - containers
+      summary: List containers (public).
+      operationId: containers_publicList
       security: []
       parameters:
         - name: collectionId
@@ -9303,30 +10007,60 @@ paths:
           required: true
           schema:
             type: string
-        - name: containerId
-          in: path
-          required: true
+        - name: containerType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: status
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/ContainerStatus"
+        - name: ref
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: parentContainerId
+          in: query
+          required: false
           schema:
             type: string
+        - name: topLevel
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationLatestResponse"
+                $ref: "#/components/schemas/PublicListContainersResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}/attestations/summary{qs}:
+  /public/collection/{collectionId}/containers/{containerId}:
     get:
       tags:
-        - attestations
-      summary: Time-series summary for a specific container (public shortcut).
-      operationId: attestations_publicContainerSummary
+        - containers
+      summary: Get a single container (public).
+      operationId: containers_publicGet
       security: []
       parameters:
         - name: collectionId
@@ -9339,30 +10073,40 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: tree
+          in: query
+          required: false
           schema:
-            type: string
+            type: boolean
+        - name: treeDepth
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: includeContents
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationSummaryResponse"
+                $ref: "#/components/schemas/Container"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}/attestations/tree-latest{qs}:
+  /public/collection/{collectionId}/containers/{containerId}/attestations:
     get:
       tags:
         - attestations
-      summary: Tree time-series summary rooted at a specific container (public shortcut).
-      operationId: attestations_publicContainerTreeLatest
+      summary: List attestations for a specific container (public shortcut).
+      operationId: attestations_publicContainerList
       security: []
       parameters:
         - name: collectionId
@@ -9375,30 +10119,60 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationTreeLatestResponse"
+                $ref: "#/components/schemas/PublicListAttestationsResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}/attestations/tree-summary{qs}:
+  /public/collection/{collectionId}/containers/{containerId}/attestations/latest:
     get:
       tags:
         - attestations
-      summary: Latest snapshot for a specific container (public shortcut).
-      operationId: attestations_publicContainerTreeSummary
+      summary: Time-series summary for a specific container (public shortcut).
+      operationId: attestations_publicContainerLatest
       security: []
       parameters:
         - name: collectionId
@@ -9411,30 +10185,25 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicAttestationTreeSummaryResponse"
+                $ref: "#/components/schemas/PublicAttestationLatestResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}/attestations{qs}:
+  /public/collection/{collectionId}/containers/{containerId}/attestations/summary:
     get:
       tags:
         - attestations
-      summary: List attestations for a specific container (public shortcut).
-      operationId: attestations_publicContainerList
+      summary: Time-series summary for a specific container (public shortcut).
+      operationId: attestations_publicContainerSummary
       security: []
       parameters:
         - name: collectionId
@@ -9447,30 +10216,65 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectType
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationSubjectType"
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: valueField
+          in: query
+          required: false
           schema:
             type: string
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationGroupBy"
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicListAttestationsResponse"
+                $ref: "#/components/schemas/PublicAttestationSummaryResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}/items{qs}:
+  /public/collection/{collectionId}/containers/{containerId}/attestations/tree-latest:
     get:
       tags:
-        - containers
-      summary: List current contents of a container (public).
-      operationId: containers_publicListItems
+        - attestations
+      summary: Tree time-series summary rooted at a specific container (public shortcut).
+      operationId: attestations_publicContainerTreeLatest
       security: []
       parameters:
         - name: collectionId
@@ -9483,30 +10287,35 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectId
+          in: query
+          required: false
           schema:
             type: string
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContainerItemsResponse"
+                $ref: "#/components/schemas/PublicAttestationTreeLatestResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers/{containerId}{qs}:
+  /public/collection/{collectionId}/containers/{containerId}/attestations/tree-summary:
     get:
       tags:
-        - containers
-      summary: Get a single container (public).
-      operationId: containers_publicGet
+        - attestations
+      summary: Latest snapshot for a specific container (public shortcut).
+      operationId: attestations_publicContainerTreeSummary
       security: []
       parameters:
         - name: collectionId
@@ -9519,30 +10328,65 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
-          in: path
-          required: true
+        - name: subjectId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: attestationType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: valueField
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/AttestationGroupBy"
+        - name: recordedAfter
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: recordedBefore
+          in: query
+          required: false
           schema:
             type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: includeItems
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Container"
+                $ref: "#/components/schemas/PublicAttestationTreeSummaryResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/containers{qs}:
+  /public/collection/{collectionId}/containers/{containerId}/items:
     get:
       tags:
         - containers
-      summary: List containers (public).
-      operationId: containers_publicList
+      summary: List current contents of a container (public).
+      operationId: containers_publicListItems
       security: []
       parameters:
         - name: collectionId
@@ -9550,18 +10394,33 @@ paths:
           required: true
           schema:
             type: string
-        - name: qs
+        - name: containerId
           in: path
           required: true
           schema:
             type: string
+        - name: history
+          in: query
+          required: false
+          schema:
+            type: boolean
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
       responses:
         200:
           description: Success
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/PublicListContainersResponse"
+                $ref: "#/components/schemas/ContainerItemsResponse"
         400:
           description: Bad request
         401:
@@ -9581,6 +10440,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeValues
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -9644,6 +10508,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: includeValues
+          in: query
+          required: false
+          schema:
+            type: boolean
       responses:
         200:
           description: Success
@@ -9724,6 +10593,47 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/interactions:
+    get:
+      tags:
+        - interactions
+      summary: interactions.publicList
+      operationId: interactions_publicList
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: appId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: number
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: number
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/InteractionTypeList"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /public/collection/{collectionId}/interactions/by-user:
     post:
       tags:
@@ -9823,37 +10733,6 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /public/collection/{collectionId}/interactions/{qs}:
-    get:
-      tags:
-        - interactions
-      summary: interactions.publicList
-      operationId: interactions_publicList
-      security: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: qs
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/InteractionTypeList"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /public/collection/{collectionId}/location/{locationId}:
     get:
       tags:
@@ -10648,6 +11527,21 @@ paths:
           required: true
           schema:
             type: string
+        - name: refType
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: refId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: embed
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -10705,6 +11599,16 @@ paths:
           required: true
           schema:
             type: string
+        - name: tagIds
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: embed
+          in: query
+          required: false
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -11192,6 +12096,41 @@ paths:
           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