@celigo/api-specs 0.2.172 → 0.2.174

package/dist/tool.yml

@@ -776,6 +776,15 @@ paths:
                     format: objectId
                   examples:
                     - 6ac1ef4a38b24d95ffac2545: 6ac1ef4a38b24d95ffac2545
+                _stackId:
+                  type: string
+                  format: objectId
+                  x-celigo-refModel: stacks
+                  description: |-
+                    Stack that the cloned steps' stack references point at. Required when the clone
+                    preview reports `stackRequired: true` (400 `stack_not_found` without it).
+                  examples:
+                    - 5f8d43a1b9e5a80011a35f2c
             examples:
               default:
                 summary: Clone a tool with no connection-bearing steps into the same integration
@@ -6358,7 +6367,9 @@ components:
                 Reference to a predefined script resource containing the transformation logic.
 
                 The referenced script should contain the function specified in the
-                'function' property.
+                'function' property. It must be a script in this account: any other id fails the save
+                with 422 ("Only a script owned by the user or a script shared by the Integration App can
+                be used at transform.script._scriptId.").
               format: objectid
               x-celigo-refModel: scripts
               examples:
@@ -7721,11 +7732,13 @@ components:
                 after which the flag switches itself off), and concurrency climbs back toward
                 `targetConcurrencyLevel`. While true, `targetConcurrencyLevel` is the throughput lever: a
                 `concurrencyLevel` sent in a PUT is ignored, and one sent in a PATCH is stored but the
-                recovery machinery moves it back toward the target.
+                recovery machinery moves it back toward the target. Recovery never runs on `ftp`
+                connections: FTP errors aren't treated as rate limits.
               x-celigo-ai-guidance:
                 - To change throughput while this is true, write `targetConcurrencyLevel`; a `concurrencyLevel` sent in a PUT returns 200 and changes nothing.
                 - Turning it on copies `concurrencyLevel` into `targetConcurrencyLevel`; turning it off unsets the target and leaves `concurrencyLevel` at its current value, which may be below the old target if a recovery was in progress. A `targetConcurrencyLevel` written while this is false is unset by the save.
                 - These four settings (`concurrencyLevel`, `targetConcurrencyLevel`, `_borrowConcurrencyFromConnectionId`, this flag) accept a credential-free `PATCH /v1/connections/{_id}`. A PUT replaces the whole document, so send each secret back as its masked `******` value (that keeps it) or as a new value, and never drop one to keep it — an omitted password or `http.encrypted` is cleared, and a static token left out (with no `refreshMethod`) fails the PUT with 422.
+                - On an `ftp` connection recovery never runs, and transfer threads are `ftp.multiThreadCount`; while this is true a create sets `ftp.concurrencyLevel` to `ftp.targetConcurrencyLevel`, or to 1 without one.
             enableMicroBatchForOneToMany:
               type: boolean
               default: true
@@ -8343,6 +8356,10 @@ components:
             FTP servers often have low connection limits — keep this value conservative.
             Send no more than the account's licensed maximum, the license's `concurrency` (25 standard,
             50 with an Environments license).
+            While `autoRecoverRateLimitErrors` is true, which a create gets unless it sends `false`, a create
+            ignores the value sent here and sets this field to `targetConcurrencyLevel`, or to 1 when no
+            target is sent. To start higher, send `targetConcurrencyLevel` too, or create with
+            `autoRecoverRateLimitErrors: false`.
             Unlike the rest of the `ftp` object, a `PUT` that omits this field keeps the stored value instead of clearing it.
           minimum: 1
           maximum: 50
@@ -8352,8 +8369,9 @@ components:
         targetConcurrencyLevel:
           type: integer
           description: |
-            Target concurrency level for auto-scaling. The system adjusts concurrency
-            between 1 and this value based on server response feedback.
+            While `autoRecoverRateLimitErrors` is true, a create sets `concurrencyLevel` to this value, and a
+            create that omits it gets 1 for both. Auto-recovery never runs on FTP connections (FTP errors
+            aren't treated as rate limits), so nothing climbs back to it.
             Kept on a `PUT` that omits it, like `concurrencyLevel`; unset by the save while
             `autoRecoverRateLimitErrors` is false.
           minimum: 1
@@ -8384,9 +8402,9 @@ components:
           type: integer
           readOnly: true
           description: |-
-            Server-maintained mirror of `multiThreadCount` used by concurrency
-            auto-scaling. Present only when rate-limit auto-recovery applies;
-            recomputed on save.
+            Server-maintained mirror of `multiThreadCount`, present while
+            `autoRecoverRateLimitErrors` is true and `targetConcurrencyLevel` is
+            set; recomputed on save.
       if:
         properties:
           type:
@@ -24176,7 +24194,9 @@ components:
               x-celigo-refModel: scripts
               description: |
                 Reference to the Script resource that contains the filtering logic. This must be a valid
-                ObjectId of a Script resource that exists in the system.
+                ObjectId of a Script resource in this account: any other id fails the save with 422
+                ("Only a script owned by the user or a script shared by the Integration App can be used
+                at filter.script._scriptId.").
 
                 The referenced script must contain the function specified in the `function` field
                 and must be written to handle filtering specifically. The script receives
@@ -24235,7 +24255,11 @@ components:
           type: string
           format: objectId
           x-celigo-refModel: scripts
-          description: Script containing the hook function named in `function`. Send this or `_stackId`, not both.
+          description: |-
+            Script containing the hook function named in `function`. Send this or `_stackId`, not both.
+            Must be a script in this account: any other id fails the save with 422, naming the hook,
+            such as "Only a script owned by the user or a script shared by the Integration App can
+            be used at hooks.preMap._scriptId." on an import's `preMap`.
         _stackId:
           type: string
           format: objectId
@@ -25862,6 +25886,15 @@ components:
                 plus whatever this step's response mapping merges back. A value later steps need
                 belongs in the source export's `preSavePage`, in this step's `postResponseMap` hook on
                 the flow, or in the later import's own `preMap`.
+
+                The function returns one element per record in `options.data`, in order:
+                `{ data: <record> }` sends the record and `{ errors: [{ code, message }] }` fails it.
+                An element without `data` — `{}`, or the record itself returned unwrapped — skips that
+                record with no error: nothing is sent and the record is reported `ignored: true` at
+                stage `preMapHook`. A return with more or fewer elements fails every record on the page
+                with `invalid_extension_response` ("Extension result doesn't contain the same number
+                of elements as the request object. Expected 2, got 1. Extension returned statusCode
+                200"), source `pre_map_hook`.
               x-celigo-ai-guidance:
                 - |-
                   Pre-map JavaScript hook — runs once per page BEFORE the
@@ -25873,7 +25906,18 @@ components:
                   renames — mappings handle those.
 
                   Runtime contract: ``options.data[]`` (the page of upstream
-                  records) → array of the same length.
+                  records) → array of the same length, each element
+                  ``{data: record}`` or ``{errors: [...]}``.  A bare record in
+                  the returned array is skipped without an error, so
+                  ``options.data.map(r => { r.total = t; return r })`` sends
+                  nothing.
+                - |-
+                  Verified live 2026-10-22 by invoking an HTTP import with a
+                  Mapper 2.0 number mapping: one ``{data: record}`` per record
+                  sent both records; the bare records sent nothing and both
+                  came back ``ignored: true``, ``stage: preMapHook``, with no
+                  error; one element for two records failed both with 422
+                  ``invalid_extension_response``.
               allOf:
                 - $ref: '#/components/schemas/Hook'
             postMap:
@@ -38163,7 +38207,10 @@ components:
                   type: string
                   format: objectId
                   x-celigo-refModel: scripts
-                  description: Script containing the hook function named in `function`.
+                  description: |-
+                    Script containing the hook function named in `function`. Must be a script in this
+                    account: any other id fails the save with 422 ("Only a script owned by the user or
+                    a script shared by the Integration App can be used at hooks.preSavePage._scriptId.").
                   examples:
                     - 60a2c4e6f321d800129a1a3c
                     - 5f8e7d2c1b54e6003a9c7e12
@@ -38274,7 +38321,10 @@ components:
           type: string
           format: objectId
           x-celigo-refModel: connectors
-          description: Connector this export was created from, set when the export is part of an installed integration app.
+          description: |-
+            Connector this export was created from, set when the export is part of an installed
+            integration app. The app's install sets it: a create that sends it is refused with 403
+            ("Cannot create an Integration App resource").
         unencrypted:
           type: object
           description: Custom configuration values stored without encryption and returned in API responses.
@@ -38432,12 +38482,18 @@ components:
                 additionalProperties: true
         stackRequired:
           type: boolean
-          description: Whether the clone requires a stack (connector-level) environment to proceed.
+          description: |-
+            `true` when the resource or one of its dependencies references a stack (a hook or
+            wrapper connection that runs on a stack). Send `_stackId` in the clone request: without
+            it the clone fails with 400 `stack_not_found`.
         _stackId:
           type:
             - string
             - 'null'
-          description: The stack id associated with the resource, or null if no stack is involved.
+          description: |-
+            The first stack the resource or a dependency references, or null. Pass it, or another
+            stack in the target environment, as `_stackId` in the clone request; the clone points
+            every stack reference at that one stack.
           examples:
             - 5f8d43a1b9e5a80011a35f2c
     DependencyEntry:

package/dist/tradingpartnerconnector.yml

@@ -928,7 +928,9 @@ components:
               x-celigo-refModel: scripts
               description: |
                 Reference to the Script resource that contains the filtering logic. This must be a valid
-                ObjectId of a Script resource that exists in the system.
+                ObjectId of a Script resource in this account: any other id fails the save with 422
+                ("Only a script owned by the user or a script shared by the Integration App can be used
+                at filter.script._scriptId.").
 
                 The referenced script must contain the function specified in the `function` field
                 and must be written to handle filtering specifically. The script receives

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.172",
+  "version": "0.2.174",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,7 +1,7 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "a3b6728d",
+		"iasCommit": "ea1eb137",
 		"generatedAt": "2026-10-22"
 	},
 	"roots": {