@proveanything/smartlinks 2.1.14 → 2.1.16

package/dist/openapi.yaml

@@ -14952,6 +14952,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /{groupId}/members:
+    post:
+      tags:
+        - ranges
+      summary: Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given.
+      operationId: ranges_addMember
+      security: []
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AddClaimSetRangeMemberResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddClaimSetRangeMemberRequest"
   /{rangeId}:
     get:
       tags:
@@ -15041,6 +15073,38 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/AssignClaimSetRangeRequest"
+  /{rangeId}/close:
+    post:
+      tags:
+        - ranges
+      summary: "Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted)."
+      operationId: ranges_close
+      security: []
+      parameters:
+        - name: rangeId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CloseClaimSetRangeResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ClaimSetScope"
   /{rangeId}/export:
     get:
       tags:
@@ -21235,6 +21299,32 @@ components:
         - id
         - title
         - component
+    ConnectorAction:
+      type: object
+      properties:
+        name:
+          type: string
+        title:
+          type: string
+        description:
+          type: string
+        function:
+          type: string
+        visibility:
+          type: string
+          enum:
+            - admin
+            - member
+            - public
+        input:
+          type: object
+          additionalProperties: true
+        output:
+          type: object
+          additionalProperties: true
+      required:
+        - name
+        - function
     AppConnectorDeclaration:
       type: object
       properties:
@@ -21288,6 +21378,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/ConnectorPanel"
+        actions:
+          type: array
+          items:
+            $ref: "#/components/schemas/ConnectorAction"
         aiGuide:
           type: string
         recordId:
@@ -25889,6 +25983,8 @@ components:
           type: string
         namespace:
           type: string
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         notes:
@@ -25942,6 +26038,7 @@ components:
         - id
         - claimSetId
         - namespace
+        - kind
         - name
         - notes
         - startIndex
@@ -25965,6 +26062,8 @@ components:
     CreateClaimSetRangeRequest:
       type: object
       properties:
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         quantity:
@@ -25988,7 +26087,6 @@ components:
           type: string
       required:
         - name
-        - quantity
     UpdateClaimSetRangeRequest:
       type: object
       properties:
@@ -26032,6 +26130,10 @@ components:
           type: string
         proofId:
           type: string
+        rangeId:
+          type: string
+        groupId:
+          type: string
         programmedAt:
           type: string
         scans:
@@ -26045,6 +26147,8 @@ components:
         - productId
         - batchId
         - proofId
+        - rangeId
+        - groupId
         - programmedAt
         - scans
     ClaimSetRangeTagsPage:
@@ -26073,6 +26177,41 @@ components:
       required:
         - url
         - remaining
+    AddClaimSetRangeMemberRequest:
+      type: object
+      properties:
+        code:
+          type: string
+        uid:
+          type: string
+        collectionId:
+          type: string
+        productId:
+          type: string
+        batchId:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+        clear:
+          type: boolean
+    AddClaimSetRangeMemberResponse:
+      type: object
+      properties:
+        tag:
+          $ref: "#/components/schemas/ClaimSetRangeTag"
+        range:
+          $ref: "#/components/schemas/ClaimSetRange"
+        assigned:
+          type: object
+          additionalProperties: true
+        movedFrom:
+          type: string
+      required:
+        - tag
+        - range
+        - assigned
+        - movedFrom
     ImportClaimSetRangeUidsRequest:
       type: object
       properties:
@@ -26273,6 +26412,12 @@ components:
         - ntag424
         - ntag21x
         - qr
+    ClaimSetRangeKind:
+      type: string
+      enum:
+        - range
+        - open
+        - group
     ClaimSetRangeStatus:
       type: string
       enum:
@@ -26281,6 +26426,11 @@ components:
         - sent
         - received
         - assigned
+        - open
+        - group
+    CloseClaimSetRangeResponse:
+      type: object
+      additionalProperties: true
     ClaimSetImportResult:
       type: string
       enum:
@@ -29060,6 +29210,10 @@ components:
           additionalProperties: true
         eventMapping:
           $ref: "#/components/schemas/EventMapping"
+        envelopeFormat:
+          type: string
+          enum:
+            - cloudevents
         connection:
           $ref: "#/components/schemas/FlowConnection"
         fieldMappings:
@@ -29520,6 +29674,8 @@ components:
     EventEnvelope:
       type: object
       properties:
+        specVersion:
+          type: number
         id:
           type: string
         type:
@@ -29547,6 +29703,10 @@ components:
           type: object
           additionalProperties:
             type: string
+        anonymousId:
+          type: string
+        sessionId:
+          type: string
         emailHash:
           type: string
         phoneHash:
@@ -29567,6 +29727,9 @@ components:
         proof:
           type: object
           additionalProperties: true
+        consent:
+          type: object
+          additionalProperties: true
         subject:
           type: object
           additionalProperties: true
@@ -29577,6 +29740,7 @@ components:
           type: object
           additionalProperties: true
       required:
+        - specVersion
         - id
         - type
         - entityType
@@ -29589,9 +29753,12 @@ components:
         - contactId
         - userId
         - externalIds
+        - anonymousId
+        - sessionId
         - identityPolicy
         - product
         - proof
+        - consent
         - subject
         - attributes
     CapturedRequest:

package/dist/types/appManifest.d.ts

@@ -1030,6 +1030,27 @@ export interface ConnectorPanel {
     /** Exported component name in the app's widgets bundle (manifest `widgets.files`). */
     component: string;
 }
+/**
+ * A named provider operation invoked ON DEMAND (not by the engine): redeem a reward, enrol a member,
+ * issue a coupon, raise a ticket, send a receipt. Called by an app function (`ctx.sl.connectors.call`),
+ * by the Hub (public route — only `public`, or `member` for a signed-in person) or by the console. The
+ * function receives `{ input, installation, caller }` and returns JSON; it runs with the connector's
+ * own credentials and is told who asked.
+ */
+export interface ConnectorAction {
+    /** `^[a-zA-Z][a-zA-Z0-9_-]{0,63}$` */
+    name: string;
+    title?: string;
+    description?: string;
+    /** This app's server function implementing it. */
+    function: string;
+    /** Who may invoke it outside functions and the console. Default 'admin'. */
+    visibility?: 'admin' | 'member' | 'public';
+    /** JSON Schema for `input`; `required` fields are checked before the function runs. */
+    input?: Record<string, unknown>;
+    /** JSON Schema for the result (documentation; not enforced). */
+    output?: Record<string, unknown>;
+}
 /**
  * The connector contract. Every function named here is one of this app's server functions
  * (manifest `functions.definitions`); the engine calls it with collection authority, capped by the
@@ -1092,6 +1113,8 @@ export interface AppConnectorDeclaration {
         lookup?: string;
     };
     panels?: ConnectorPanel[];
+    /** On-demand operations the connector offers (see ConnectorAction). */
+    actions?: ConnectorAction[];
     /** Path (under the app's public files) of a guide the AI mapping assistant reads. */
     aiGuide?: string;
     /**

package/dist/types/claimSet.d.ts

@@ -129,21 +129,32 @@ export type ClaimSetScope = {
     partnerId: string;
 };
 export type ClaimSetTagType = 'ntag424' | 'ntag21x' | 'qr';
-export type ClaimSetRangeStatus = 'minting' | 'minted' | 'sent' | 'received' | 'assigned';
+/**
+ * range: a contiguous block of indexes minted up front. open: grows one index per tag programmed on a phone
+ * (count unknown in advance), closed into a range later. group: existing tags added by tapping, assigned by
+ * hand and moved together; no indexes.
+ */
+export type ClaimSetRangeKind = 'range' | 'open' | 'group';
+export type ClaimSetRangeStatus = 'minting' | 'minted' | 'sent' | 'received' | 'assigned' | 'open' | 'group';
 export interface ClaimSetRange {
     id: string;
     claimSetId: string;
     namespace: string;
+    kind: ClaimSetRangeKind;
     name: string;
     notes: string | null;
-    startIndex: number;
-    endIndex: number;
+    /** null for a group */
+    startIndex: number | null;
+    /** open: the highest index minted so far (null until the first); group: null */
+    endIndex: number | null;
+    /** range: the block; open: minted so far; group: its members */
     quantity: number;
     tagType: ClaimSetTagType;
+    /** open ranges and groups are always 'sidekick' */
     fulfilment: 'printer' | 'sidekick';
-    /** The stored step: minting | minted | sent | received */
+    /** The stored step: minting | minted | sent | received (always 'minted' for open ranges and groups) */
     stage: 'minting' | 'minted' | 'sent' | 'received';
-    /** What to show: the stage, or 'assigned' once every tag is assigned */
+    /** What to show: the stage, 'open', 'group', or 'assigned' once every tag is assigned */
     status: ClaimSetRangeStatus;
     intendedCollectionId: string | null;
     intendedProductId: string | null;
@@ -162,9 +173,11 @@ export interface ClaimSetRange {
     updatedAt: string;
 }
 export interface CreateClaimSetRangeRequest {
+    /** Default 'range'. Owners and admins make ranges and open ranges; assigners may make groups too. */
+    kind?: ClaimSetRangeKind;
     name: string;
-    /** 1 to 10,000 */
-    quantity: number;
+    /** 1 to 10,000 (a range); ignored for open ranges and groups */
+    quantity?: number;
     /** Pre-assign every tag at mint time (you must administer the collection) */
     intendedCollectionId?: string;
     intendedProductId?: string;
@@ -194,6 +207,10 @@ export interface ClaimSetRangeTag {
     productId: string | null;
     batchId: string | null;
     proofId: string | null;
+    /** The range it was minted into, if any */
+    rangeId: string | null;
+    /** The group it was added to, if any */
+    groupId: string | null;
     programmedAt: string | null;
     scans: number;
 }
@@ -207,8 +224,42 @@ export interface ClaimSetRangeNextTag extends ClaimSetRangeTag {
     url: string;
     piccOffset?: number;
     mirrorOffset?: number;
-    remaining: number;
+    /** Tags still without a chip; null for an open range (it grows as you go) */
+    remaining: number | null;
+}
+/** Add an existing tag of the set to a group, and (with a collection, or clear) assign it as you go. */
+export interface AddClaimSetRangeMemberRequest {
+    /** The tag's code, printed or bare… */
+    code?: string;
+    /** …or its chip UID (14 hex) */
+    uid?: string;
+    collectionId?: string;
+    productId?: string;
+    batchId?: string;
+    data?: Record<string, unknown>;
+    clear?: boolean;
 }
+export interface AddClaimSetRangeMemberResponse {
+    tag: ClaimSetRangeTag;
+    range: ClaimSetRange;
+    /** The assignment, with the same skips as assign (has_proof, assigned_elsewhere) */
+    assigned: {
+        changed: number;
+        skipped: Array<{
+            code: string;
+            index: number | null;
+            reason: 'other_range' | 'has_proof' | 'assigned_elsewhere';
+            collectionId?: string;
+        }>;
+    };
+    /** The group the tag was taken from, if it was in another one */
+    movedFrom: string | null;
+}
+/** Closing an open range: the range it became, or that it was removed because nothing was minted. */
+export type CloseClaimSetRangeResponse = ClaimSetRange | {
+    id: string;
+    deleted: true;
+};
 export type ClaimSetImportResult = 'ok' | 'unchanged' | 'unknown_code' | 'duplicate_row' | 'index_mismatch' | 'no_uid' | 'bad_uid' | 'duplicate_uid' | 'uid_in_use' | 'uid_conflict';
 export interface ImportClaimSetRangeUidsRequest {
     /** The manufacturer's file as CSV text (the file we sent, with UID filled in) */

package/dist/types/integrations.d.ts

@@ -92,6 +92,12 @@ export interface IntegrationFlowConfig {
     };
     /** Event-sourced flows: fold SmartLinks events into the provider's registered events. */
     eventMapping?: EventMapping;
+    /**
+     * Wrap each delivered body as a CloudEvents 1.0 structured event
+     * ({ specversion, id, type, source, subject, time, datacontenttype, dataschema, data }) — the shape
+     * event buses, lakes and serverless tools consume without custom code.
+     */
+    envelopeFormat?: 'cloudevents';
     connection?: FlowConnection;
     fieldMappings?: FieldMapping[];
     /** Run this flow through a connector app's functions instead of the built-in mapper/transport. */
@@ -369,6 +375,8 @@ export interface ConnectorLookupResult {
  * connector's `serialize` / `send`, after the flow's identity policy and event mapping.
  */
 export interface EventEnvelope {
+    /** Schema version of this envelope. Bumped only when a consumer could break (a field removed or changed). */
+    specVersion: number;
     /** The event's id: stable across retries; use it as the provider's transaction / idempotency id. */
     id: string;
     /** Spine event name, e.g. 'interaction.submitted:<typeId>', 'contact.updated', 'tag.scanned:scan_redirect'. */
@@ -384,6 +392,9 @@ export interface EventEnvelope {
         userId: string | null;
         /** Ids other systems know this person by, keyed by system (a connector's `provider`). */
         externalIds: Record<string, string>;
+        /** The visitor / device id before anyone signed in (an analytics destination stitches on it later). Under every policy. */
+        anonymousId: string | null;
+        sessionId: string | null;
         emailHash?: string | null;
         phoneHash?: string | null;
         hashAlgorithm?: 'hmac-sha256' | null;
@@ -403,6 +414,15 @@ export interface EventEnvelope {
     proof: {
         id: string;
     } | null;
+    /**
+     * The person's communication consent, summarised per channel from the contact's comms state; null
+     * when the event is about nobody we hold. A CRM or CDP must not act against it.
+     */
+    consent: {
+        channels: Record<'email' | 'sms' | 'push' | 'whatsapp', 'opted_in' | 'opted_out' | 'suppressed' | 'unknown'>;
+        topics: Record<string, boolean>;
+        updatedAt: string | null;
+    } | null;
     /** The event's own fields: an interaction's interactionId / outcome / metadata, a scan's codeId / country, a contact's profile. */
     subject: Record<string, unknown>;
     /** From the flow's event mapping, when it has one. */

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.1.14  |  Generated: 2026-11-09T13:01:05.900Z
+Version: 2.1.16  |  Generated: 2026-11-10T17:19:48.505Z
 
 This is a concise summary of all available API functions and types.
 
@@ -65,7 +65,7 @@ For detailed guides on specific features:
 - **[Analytics Metadata Conventions](analytics-metadata-conventions.md)** - Standard recommended keys and conventions for analytics metadata fields
 - **[Loyalty: Points, Members & Earning Rules](loyalty.md)** - Loyalty schemes, automatic point earning via interaction rules, member balances, transaction history, and manual adjustments
 - **[Integrations](integrations.md)** - Inbound/outbound integration flows + the sealed-secret store; triggers (manual/event/schedule), event patterns, the event envelope (interaction/contact/event sources), identity policy, event mapping, signed deliveries, contact as a target, field mappings
-- **[Connectors](connectors.md)** - Connector apps (adapters for one external provider): a manifest `connector` block + server functions (testConnection/describeTarget/sample/fetch/shape/serialize/send/describeEvents/lookup); loyalty and CRM connectors; core does the mapping
+- **[Connectors](connectors.md)** - Connector apps (adapters for one external provider): a manifest `connector` block + server functions (testConnection/describeTarget/sample/fetch/shape/serialize/send/describeEvents/lookup); loyalty and CRM connectors; actions (provider operations on demand); core does the mapping
 - **[Entitlements](entitlements.md)** - "Is this person gold or above?" answered on demand from signed claims, a connector lookup (cached), or the contact — never a mirrored member base; gates on interaction types and in server functions
 - **[AI Tools & Skills](ai-tools-and-skills.md)** - The AI capability catalog: skills apps invoke by name (e.g. research.brand), the tools the AI reaches for (web fetch/screenshot/brand assets/image gen), the agent loop, and how apps discover them
 - **[Deep Link Discovery](deep-link-discovery.md)** - Registering and discovering navigable app states for portal menus and AI orchestration
@@ -3112,6 +3112,19 @@ interface ConnectorPanel {
 }
 ```
 
+**ConnectorAction** (interface)
+```typescript
+interface ConnectorAction {
+  name: string
+  title?: string
+  description?: string
+  function: string
+  visibility?: 'admin' | 'member' | 'public'
+  input?: Record<string, unknown>
+  output?: Record<string, unknown>
+}
+```
+
 **AppConnectorDeclaration** (interface)
 ```typescript
 interface AppConnectorDeclaration {
@@ -3134,6 +3147,7 @@ interface AppConnectorDeclaration {
   lookup?: string
   }
   panels?: ConnectorPanel[]
+  actions?: ConnectorAction[]
   aiGuide?: string
   recordId?: string
   limits?: { requestsPerSecond?: number; maxEvents?: number; maxAttributes?: number }
@@ -5761,10 +5775,11 @@ interface ClaimSetRange {
   id: string
   claimSetId: string
   namespace: string
+  kind: ClaimSetRangeKind
   name: string
   notes: string | null
-  startIndex: number
-  endIndex: number
+  startIndex: number | null
+  endIndex: number | null
   quantity: number
   tagType: ClaimSetTagType
   fulfilment: 'printer' | 'sidekick'
@@ -5787,8 +5802,9 @@ interface ClaimSetRange {
 **CreateClaimSetRangeRequest** (interface)
 ```typescript
 interface CreateClaimSetRangeRequest {
+  kind?: ClaimSetRangeKind
   name: string
-  quantity: number
+  quantity?: number
   intendedCollectionId?: string
   intendedProductId?: string
   intendedBatchId?: string
@@ -5823,6 +5839,8 @@ interface ClaimSetRangeTag {
   productId: string | null
   batchId: string | null
   proofId: string | null
+  rangeId: string | null
+  groupId: string | null
   programmedAt: string | null
   scans: number
 }
@@ -5836,6 +5854,29 @@ interface ClaimSetRangeTagsPage {
 }
 ```
 
+**AddClaimSetRangeMemberRequest** (interface)
+```typescript
+interface AddClaimSetRangeMemberRequest {
+  code?: string
+  uid?: string
+  collectionId?: string
+  productId?: string
+  batchId?: string
+  data?: Record<string, unknown>
+  clear?: boolean
+}
+```
+
+**AddClaimSetRangeMemberResponse** (interface)
+```typescript
+interface AddClaimSetRangeMemberResponse {
+  tag: ClaimSetRangeTag
+  range: ClaimSetRange
+  assigned: { changed: number; skipped: Array<{ code: string; index: number | null; reason: 'other_range' | 'has_proof' | 'assigned_elsewhere'; collectionId?: string }> }
+  movedFrom: string | null
+}
+```
+
 **ImportClaimSetRangeUidsRequest** (interface)
 ```typescript
 interface ImportClaimSetRangeUidsRequest {
@@ -5944,7 +5985,11 @@ type ClaimSetScope = { collectionId: string }
 
 **ClaimSetTagType** = `'ntag424' | 'ntag21x' | 'qr'`
 
-**ClaimSetRangeStatus** = `'minting' | 'minted' | 'sent' | 'received' | 'assigned'`
+**ClaimSetRangeKind** = `'range' | 'open' | 'group'`
+
+**ClaimSetRangeStatus** = `'minting' | 'minted' | 'sent' | 'received' | 'assigned' | 'open' | 'group'`
+
+**CloseClaimSetRangeResponse** = `ClaimSetRange | { id: string`
 
 **ClaimSetImportResult** = ``
 
@@ -7980,6 +8025,7 @@ interface IntegrationFlowConfig {
   signing?: { credentialRef: string; previousCredentialRef?: string }
   identity?: { policy?: IdentityPolicy; hashKeyCredentialRef?: string }
   eventMapping?: EventMapping
+  envelopeFormat?: 'cloudevents'
   connection?: FlowConnection
   fieldMappings?: FieldMapping[]
   connector?: FlowConnectorRef
@@ -8222,6 +8268,7 @@ interface ConnectorLookupResult {
 **EventEnvelope** (interface)
 ```typescript
 interface EventEnvelope {
+  specVersion: number
   id: string
   type: string
   entityType: string | null
@@ -8234,6 +8281,8 @@ interface EventEnvelope {
   contactId: string | null
   userId: string | null
   externalIds: Record<string, string>
+  anonymousId: string | null
+  sessionId: string | null
   emailHash?: string | null
   phoneHash?: string | null
   hashAlgorithm?: 'hmac-sha256' | null
@@ -8243,6 +8292,7 @@ interface EventEnvelope {
   identityPolicy: IdentityPolicy
   product: { id: string; name?: string | null; sku?: string | null; gtin?: string | null; variantId?: string | null; batchId?: string | null } | null
   proof: { id: string } | null
+  consent: { channels: Record<'email' | 'sms' | 'push' | 'whatsapp', 'opted_in' | 'opted_out' | 'suppressed' | 'unknown'>; topics: Record<string, boolean>; updatedAt: string | null } | null
   subject: Record<string, unknown>
   event?: { name: string; attributes: Record<string, unknown>; rule: string | null }
   attributes: Record<string, unknown>
@@ -12445,6 +12495,15 @@ Name, notes, order details, or a stage move (sent to the printer, received).
 **resume**(scope: ClaimSetScope, claimSetId: string, rangeId: string) → `Promise<ClaimSetRange>`
 Finish minting a range that was interrupted.
 
+**close**(scope: ClaimSetScope, claimSetId: string, rangeId: string) → `Promise<CloseClaimSetRangeResponse>`
+Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted).
+
+**addMember**(scope: ClaimSetScope, claimSetId: string, groupId: string, params: AddClaimSetRangeMemberRequest) → `Promise<AddClaimSetRangeMemberResponse>`
+Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given.
+
+**removeMember**(scope: ClaimSetScope, claimSetId: string, groupId: string, code: string) → `Promise<`
+Take a tag out of a group. Its assignment is left as it is.
+
 **tags**(scope: ClaimSetScope, claimSetId: string, rangeId: string,
       options: { from?: number; limit?: number; keys?: boolean } = {}) → `Promise<ClaimSetRangeTagsPage>`
 The range's tags in index order, a page at a time (keys: owners/admins only).
@@ -12984,6 +13043,22 @@ Save a connector's non-secret Connect-form values and/or settings. PUT /integrat
     input: Record<string, unknown> & { flowId?: string } = {}) → `Promise<T>`
 Run a connector step from the console: `testConnection` → ConnectorTestResult, `describeTarget` → ConnectorTargetSchema, `sample` → ConnectorRecords, and dry runs of `shape` ({ records }) → ConnectorShapeResult and `serialize` ({ documents }) → ConnectorSerializeResult. The server adds the installation; pass `flowId` to layer that flow's settings. POST /integrations/connectors/:appId/steps/:step
 
+**runConnectorAction**(collectionId: string,
+    appId: string,
+    action: string,
+    input: Record<string, unknown> = {}) → `Promise<T>`
+Invoke a connector ACTION from the console (any visibility): redeem, enrol, adjust points, issue a coupon… The connector's function runs with its own credentials and is told who asked. POST /integrations/connectors/:appId/actions/:action { input }
+
+**listConnectorActions**(collectionId: string,
+    appId: string) → `Promise<`
+PUBLIC (the Hub, a site): the connector actions the caller may invoke — those declared `public`, plus `member` ones when signed in. GET /public/collection/:collectionId/connectors/:appId/actions
+
+**callConnectorAction**(collectionId: string,
+    appId: string,
+    action: string,
+    input: Record<string, unknown> = {}) → `Promise<T>`
+PUBLIC (the Hub, a site): invoke a connector action — e.g. redeem a reward for the signed-in member. 401 SIGN_IN_REQUIRED for a `member` action without a session; 403 for an admin-only one; 400 with `missing[]` when a required input is absent. POST /public/collection/:collectionId/connectors/:appId/actions/:action { input }
+
 ### interactions
 
 **query**(collectionId: string,