@proveanything/smartlinks 1.9.13 → 1.9.14

package/dist/openapi.yaml

@@ -1976,12 +1976,12 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/BroadcastSendTestRequest"
-  /admin/collection/{collectionId}/claimSet:
-    get:
+  /admin/collection/{collectionId}/claimSetd)}/assignClaims:
+    post:
       tags:
         - claimSet
-      summary: Get all claim sets for a collection.
-      operationId: claimSet_getAllForCollection
+      summary: Perform a tag query for a collection.
+      operationId: claimSet_assignClaims
       security:
         - bearerAuth: []
       parameters:
@@ -1995,20 +1995,25 @@ paths:
           description: Success
           content:
             application/json:
-              schema:
-                type: array
-                items: {}
+              schema: {}
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AssignClaimsRequest"
+  /admin/collection/{collectionId}/claimSetd)}/makeClaim:
     post:
       tags:
         - claimSet
-      summary: Perform a tag query for a collection.
-      operationId: claimSet_createForCollection
+      summary: Get tag summary for a collection.
+      operationId: claimSet_makeClaim
       security:
         - bearerAuth: []
       parameters:
@@ -2029,11 +2034,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-    put:
+  /admin/collection/{collectionId}/claimSetd)}/tagQuery:
+    post:
       tags:
         - claimSet
-      summary: Create a new claim set for a collection.
-      operationId: claimSet_updateForCollection
+      summary: Get a report for a claim set (collection-scoped).
+      operationId: claimSet_tagQuery
       security:
         - bearerAuth: []
       parameters:
@@ -2054,12 +2060,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/assignClaims:
-    post:
+  /admin/collection/{collectionId}/claimSetd)}/tagSummary:
+    get:
       tags:
         - claimSet
-      summary: Assign claims to a claim set.
-      operationId: claimSet_assignClaims
+      summary: Get a report for a claim set (collection-scoped).
+      operationId: claimSet_getTagSummary
       security:
         - bearerAuth: []
       parameters:
@@ -2080,18 +2086,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/AssignClaimsRequest"
-  /admin/collection/{collectionId}/claimSet/makeClaim:
+  /admin/collection/{collectionId}/claimSetd)}/updateClaimData:
     post:
       tags:
         - claimSet
-      summary: Update a claim set for a collection.
-      operationId: claimSet_makeClaim
+      summary: Make a claim against a claim set (collection-scoped).
+      operationId: claimSet_updateClaimData
       security:
         - bearerAuth: []
       parameters:
@@ -2112,12 +2112,18 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/tagQuery:
-    post:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UpdateClaimDataRequest"
+  /admin/collection/{collectionId}/claimSetd)}/{claimSetId}:
+    get:
       tags:
         - claimSet
-      summary: Get tag summary for a collection.
-      operationId: claimSet_tagQuery
+      summary: Returns the base path for claim set endpoints.
+      operationId: claimSet_get
       security:
         - bearerAuth: []
       parameters:
@@ -2126,6 +2132,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: claimSetId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -2138,12 +2149,11 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/tagSummary:
-    get:
+    put:
       tags:
         - claimSet
-      summary: Get assigned tags for a claim set.
-      operationId: claimSet_getTagSummary
+      summary: Create a new claim set.
+      operationId: claimSet_update
       security:
         - bearerAuth: []
       parameters:
@@ -2152,6 +2162,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: claimSetId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -2164,12 +2179,11 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/updateClaimData:
-    post:
+    delete:
       tags:
         - claimSet
-      summary: Update claim data for a collection.
-      operationId: claimSet_updateClaimData
+      summary: Update a claim set.
+      operationId: claimSet_remove
       security:
         - bearerAuth: []
       parameters:
@@ -2178,6 +2192,11 @@ paths:
           required: true
           schema:
             type: string
+        - name: claimSetId
+          in: path
+          required: true
+          schema:
+            type: string
       responses:
         200:
           description: Success
@@ -2190,18 +2209,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/UpdateClaimDataRequest"
-  /admin/collection/{collectionId}/claimSet/{claimSetId}:
+  /admin/collection/{collectionId}/claimSetd)}/{claimSetId}/assignedTags:
     get:
       tags:
         - claimSet
-      summary: Get all claim sets for a collection.
-      operationId: claimSet_getForCollection
+      summary: Get all tags for a claim set (including data).
+      operationId: claimSet_getAssignedTags
       security:
         - bearerAuth: []
       parameters:
@@ -2227,12 +2240,12 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/{claimSetId}/assignedTags:
-    get:
+  /admin/collection/{collectionId}/claimSetd)}/{claimSetId}/createTag:
+    post:
       tags:
         - claimSet
-      summary: Get a report for a claim set.
-      operationId: claimSet_getAssignedTags
+      summary: Get assigned tags for a claim set — tags soft-assigned to a collection or product.
+      operationId: claimSet_createTag
       security:
         - bearerAuth: []
       parameters:
@@ -2251,19 +2264,26 @@ paths:
           description: Success
           content:
             application/json:
-              schema: {}
+              schema:
+                $ref: "#/components/schemas/CreateClaimSetTagResponse"
         400:
           description: Bad request
         401:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/{claimSetId}/createTag:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateClaimSetTagRequest"
+  /admin/collection/{collectionId}/claimSetd)}/{claimSetId}/importTags:
     post:
       tags:
         - claimSet
-      summary: Update claim data for a collection.
-      operationId: claimSet_createTag
+      summary: Create a single tag inside a claim set.
+      operationId: claimSet_importTags
       security:
         - bearerAuth: []
       parameters:
@@ -2283,7 +2303,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/CreateClaimSetTagResponse"
+                $ref: "#/components/schemas/ImportClaimSetTagsResponse"
         400:
           description: Bad request
         401:
@@ -2295,12 +2315,12 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/CreateClaimSetTagRequest"
-  /admin/collection/{collectionId}/claimSet/{claimSetId}/report:
+              $ref: "#/components/schemas/ImportClaimSetTagsRequest"
+  /admin/collection/{collectionId}/claimSetd)}/{claimSetId}/report:
     get:
       tags:
         - claimSet
-      summary: Get all tags for a claim set.
+      summary: Bulk import tags into a claim set.
       operationId: claimSet_getReport
       security:
         - bearerAuth: []
@@ -2327,11 +2347,11 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/claimSet/{claimSetId}/tags:
+  /admin/collection/{collectionId}/claimSetd)}/{claimSetId}/tags:
     get:
       tags:
         - claimSet
-      summary: Get a specific claim set for a collection.
+      summary: Update a claim set.
       operationId: claimSet_getAllTags
       security:
         - bearerAuth: []
@@ -2351,9 +2371,7 @@ paths:
           description: Success
           content:
             application/json:
-              schema:
-                type: array
-                items: {}
+              schema: {}
         400:
           description: Bad request
         401:
@@ -8656,38 +8674,6 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /platform/claimSet/{claimSetId}/createTag:
-    post:
-      tags:
-        - claimSet
-      summary: Create a single tag/code inside an existing claim set (platform; requires account.features.adminClaimSets).
-      operationId: claimSet_createTagPlatform
-      security: []
-      parameters:
-        - name: claimSetId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/CreateClaimSetTagResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/CreateClaimSetTagRequest"
   /platform/location:
     post:
       tags:
@@ -16896,6 +16882,51 @@ components:
         data:
           type: object
           additionalProperties: true
+    CreateClaimSetRequest:
+      type: object
+      properties:
+        name:
+          type: string
+        claimMode:
+          type: string
+        allocationMode:
+          type: string
+      required:
+        - name
+        - claimMode
+        - allocationMode
+    ImportClaimSetTagItem:
+      type: object
+      properties:
+        id:
+          type: string
+        tagId:
+          type: string
+        index:
+          type: number
+      required:
+        - id
+    ImportClaimSetTagsRequest:
+      type: object
+      properties:
+        tags:
+          type: array
+          items:
+            $ref: "#/components/schemas/ImportClaimSetTagItem"
+        mode:
+          type: string
+          enum:
+            - upsert
+            - replace
+      required:
+        - tags
+    ImportClaimSetTagsResponse:
+      type: object
+      properties:
+        written:
+          type: number
+      required:
+        - written
     CreateClaimSetTagResponse:
       type: object
       properties:

package/dist/types/claimSet.d.ts

@@ -57,6 +57,48 @@ export interface CreateClaimSetTagRequest {
     /** Arbitrary extra fields */
     data?: Record<string, unknown>;
 }
+/**
+ * Request body for creating a new claim set.
+ */
+export interface CreateClaimSetRequest {
+    /** Display name for the claim set */
+    name: string;
+    /** How tags are claimed (e.g. "nfc", "qr") */
+    claimMode: string;
+    /** How tags are allocated (e.g. "specific", "random") */
+    allocationMode: string;
+}
+/**
+ * A single tag entry within an importTags request.
+ */
+export interface ImportClaimSetTagItem {
+    /** Tag identifier (required) */
+    id: string;
+    /** Optional matching tag/NFC identifier */
+    tagId?: string;
+    /** Optional position index */
+    index?: number;
+}
+/**
+ * Request body for bulk-importing tags into a claim set.
+ */
+export interface ImportClaimSetTagsRequest {
+    /** Array of tag objects to import */
+    tags: ImportClaimSetTagItem[];
+    /**
+     * Import mode:
+     * - "upsert" (default) merges with existing tags
+     * - "replace" wipes all existing tags first then writes the new set
+     */
+    mode?: 'upsert' | 'replace';
+}
+/**
+ * Response returned by the importTags endpoint.
+ */
+export interface ImportClaimSetTagsResponse {
+    /** Number of tags written */
+    written: number;
+}
 /**
  * Response body returned after a tag/code is created inside a claim set.
  */

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.9.13  |  Generated: 2026-03-31T17:02:49.636Z
+Version: 1.9.14  |  Generated: 2026-03-31T19:46:30.667Z
 
 This is a concise summary of all available API functions and types.
 
@@ -2866,6 +2866,42 @@ interface CreateClaimSetTagRequest {
 }
 ```
 
+**CreateClaimSetRequest** (interface)
+```typescript
+interface CreateClaimSetRequest {
+  name: string
+  claimMode: string
+  allocationMode: string
+}
+```
+
+**ImportClaimSetTagItem** (interface)
+```typescript
+interface ImportClaimSetTagItem {
+  id: string
+  tagId?: string
+  index?: number
+}
+```
+
+**ImportClaimSetTagsRequest** (interface)
+```typescript
+interface ImportClaimSetTagsRequest {
+  tags: ImportClaimSetTagItem[]
+  * Import mode:
+  * - "upsert" (default) merges with existing tags
+  * - "replace" wipes all existing tags first then writes the new set
+  mode?: 'upsert' | 'replace'
+}
+```
+
+**ImportClaimSetTagsResponse** (interface)
+```typescript
+interface ImportClaimSetTagsResponse {
+  written: number
+}
+```
+
 **CreateClaimSetTagResponse** (interface)
 ```typescript
 interface CreateClaimSetTagResponse {
@@ -7425,20 +7461,39 @@ Create a Responses API request (streaming or non-streaming)
 
 ### claimSet
 
-**getAllForCollection**(collectionId: string) → `Promise<any[]>`
-Get all claim sets for a collection.
+**getAll**(collectionId?: string) → `Promise<any[]>`
+Get all claim sets. When collectionId is provided, returns claim sets for that collection. When omitted, returns all claim sets owned by the authenticated user.
 
-**getForCollection**(collectionId: string, claimSetId: string) → `Promise<any>`
-Get a specific claim set for a collection.
+**get**(claimSetId: string, collectionId?: string) → `Promise<any>`
+Get a specific claim set by ID.
 
-**getAllTags**(collectionId: string, claimSetId: string) → `Promise<any[]>`
-Get all tags for a claim set.
+**create**(params: CreateClaimSetRequest, collectionId?: string) → `Promise<any>`
+Create a new claim set. When collectionId is provided, creates it scoped to that collection. When omitted, creates a global user-owned claim set.
 
-**getReport**(collectionId: string, claimSetId: string) → `Promise<any>`
-Get a report for a claim set.
+**update**(claimSetId: string, params: any, collectionId?: string) → `Promise<any>`
+Update a claim set.
+
+**remove**(claimSetId: string, collectionId?: string) → `Promise<any>`
+Delete (soft-delete) a claim set.
+
+**getAllTags**(claimSetId: string, collectionId?: string) → `Promise<any>`
+Get all tags for a claim set (including data).
+
+**getAssignedTags**(claimSetId: string, collectionId?: string) → `Promise<any>`
+Get assigned tags for a claim set — tags soft-assigned to a collection or product.
 
-**getAssignedTags**(collectionId: string, claimSetId: string) → `Promise<any>`
-Get assigned tags for a claim set.
+**createTag**(claimSetId: string,
+    data: CreateClaimSetTagRequest,
+    collectionId?: string) → `Promise<CreateClaimSetTagResponse>`
+Create a single tag inside a claim set.
+
+**importTags**(claimSetId: string,
+    data: ImportClaimSetTagsRequest,
+    collectionId?: string) → `Promise<ImportClaimSetTagsResponse>`
+Bulk import tags into a claim set.
+
+**getReport**(collectionId: string, claimSetId: string) → `Promise<any>`
+Get a report for a claim set (collection-scoped).
 
 **getTagSummary**(collectionId: string) → `Promise<any>`
 Get tag summary for a collection.
@@ -7446,29 +7501,14 @@ Get tag summary for a collection.
 **tagQuery**(collectionId: string, data: any) → `Promise<any>`
 Perform a tag query for a collection.
 
-**createForCollection**(collectionId: string, params: any) → `Promise<any>`
-Create a new claim set for a collection.
-
-**updateForCollection**(collectionId: string, params: any) → `Promise<any>`
-Update a claim set for a collection.
-
 **makeClaim**(collectionId: string, params: any) → `Promise<any>`
-Make a claim for a claim set.
+Make a claim against a claim set (collection-scoped).
 
 **assignClaims**(collectionId: string, data: AssignClaimsRequest) → `Promise<any>`
-Assign claims to a claim set. { id: string,          // claim set id (required) collectionId: string,// required productId: string,   // required batchId?: string,    // optional start?: number,      // optional bulk range start end?: number,        // optional bulk range end codeId?: string,     // optional single code data?: { [k: string]: any } // optional claim key/values }
+Assign claims to codes or ranges within a collection.
 
 **updateClaimData**(collectionId: string, data: UpdateClaimDataRequest) → `Promise<any>`
-Update claim data for a collection.
-
-**createTag**(collectionId: string,
-    claimSetId: string,
-    data: CreateClaimSetTagRequest) → `Promise<CreateClaimSetTagResponse>`
-Create a single tag/code inside an existing claim set (collection admin). POST /admin/collection/:collectionId/claimSet/:claimSetId/createTag
-
-**createTagPlatform**(claimSetId: string,
-    data: CreateClaimSetTagRequest) → `Promise<CreateClaimSetTagResponse>`
-Create a single tag/code inside an existing claim set (platform; requires account.features.adminClaimSets). POST /platform/claimSet/:claimSetId/createTag
+Update claim data for a claim set (collection-scoped).
 
 ### collection