npm - @proveanything/smartlinks - Versions diffs - 1.9.4 → 1.9.6 - Mend

@proveanything/smartlinks 1.9.4 → 1.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/docs/API_SUMMARY.md +140 -1
package/dist/docs/translations.md +82 -0
package/dist/http.js +8 -1
package/dist/iframeResponder.js +9 -2
package/dist/openapi.yaml +1438 -496
package/dist/types/iframeResponder.d.ts +2 -0
package/docs/API_SUMMARY.md +140 -1
package/docs/translations.md +82 -0
package/openapi.yaml +1438 -496
package/package.json +1 -1

package/dist/openapi.yaml CHANGED Viewed

@@ -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
@@ -17823,6 +18762,9 @@ components:
         data: {}
         error:
           type: string
+        statusCode:
+          type: number
+        errorBody: {}
       required:
         - _smartlinksProxyResponse
         - id