@celigo/api-specs 0.2.172 → 0.2.174

package/dist/account.yml

@@ -383,13 +383,12 @@ paths:
                   summary: One stack available
                   value:
                     - _id: 69f536192e7966f4032f2299
-                      name: Production On-Prem Agent
+                      name: Production extension server
                       type: server
                       server:
-                        hostURI: https://agent.example.com:7020
-                        systemToken: '********'
-                        ipRanges:
-                          - 10.0.0.0/8
+                        hostURI: https://extensions.example.com:7020
+                        systemToken: '******'
+                        ipRanges: []
                 empty:
                   summary: No stacks available
                   value: []
@@ -842,7 +841,7 @@ components:
         name:
           type: string
           examples:
-            - Production On-Prem Agent
+            - Production extension server
           description: Display name shown in the UI when selecting a stack.
         type:
           type: string
@@ -850,31 +849,32 @@ components:
             - server
             - lambda
           x-enumDescriptions:
-            server: On-premise agent installed on your own infrastructure.
+            server: Your own server, which Celigo calls to run hook and wrapper code.
             lambda: AWS Lambda function managed in your own AWS account.
           description: Execution environment type that determines which configuration block is present.
         server:
           type: object
-          description: Configuration for the on-premise agent process. Present when `type` is `server`.
+          description: Configuration of a server stack. Present when `type` is `server`.
           properties:
             systemToken:
               type: string
               description: |-
-                Token the on-premise agent uses to authenticate with the
-                Celigo platform. Masked in GET responses.
+                System token for authenticating with the server stack. Masked in
+                GET responses.
             hostURI:
               type: string
               format: uri
               examples:
-                - https://agent.example.com:7020
+                - https://extensions.example.com:7020
               description: |-
-                Base URL where the on-premise agent is reachable.
-                The platform sends integration traffic to this address.
+                Base URI of the server hosting the stack. The platform calls it to
+                run hooks and wrappers.
             ipRanges:
               type: array
               description: |-
-                CIDR ranges allowed to connect to the agent. Requests from
-                IPs outside these ranges are rejected.
+                Deprecated and not enforced: the list is stored and returned as
+                sent, but no Celigo service checks it. Restrict who can reach the
+                server at the server or its firewall.
               items:
                 type: string
                 examples:

package/dist/ai-agent.yml

@@ -4860,7 +4860,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
@@ -5597,7 +5599,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:
@@ -5630,7 +5634,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

package/dist/api.yml

@@ -2560,8 +2560,12 @@ components:
     Script:
       type: object
       description: |-
-        Script-mode configuration. The referenced function receives the request object
-        and must return a response with `statusCode`, `headers`, and `body`.
+        Script-mode configuration. Callers reach the API at `/v1/apis/{_id}/request`, and the
+        referenced function is called with one `options` object: `method`, `headers` (the
+        request's headers, without `Authorization`), `queryString` (the parsed query string),
+        `body`, and `rawBody` (the body as received, a string). On a GET, `body` is absent and
+        `rawBody` is empty. It returns `{statusCode, headers, body}`: `headers` is optional,
+        and `body` may be any JSON value, an array included.
       properties:
         _scriptId:
           type: string
@@ -2581,8 +2585,15 @@ components:
         - function
       x-celigo-ai-guidance:
         - |-
-          In script mode, you provide a custom JavaScript function that receives the request
-          object and returns the response. This gives you complete control over the API behavior.
+          In script mode, you provide a custom JavaScript function that receives the `options`
+          object (`method`, `headers` without `Authorization`, `queryString`, `body`, `rawBody`)
+          and returns the response. This gives you complete control over the API behavior.
+        - |-
+          The function gets no `pathParams` or `queryParams`: read the query from `queryString`.
+          A return without `statusCode`, or with a `null` or missing `body`, answers the caller
+          501 ("'StatusCode' returned by the script cannot be undefined." or "'body' returned by
+          the script cannot be undefined or null."), and an error the function throws answers
+          422 with its message. Any other `statusCode` is sent as returned.
     items:
       type: object
       required:
@@ -5443,11 +5454,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
@@ -6065,6 +6078,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
@@ -6074,8 +6091,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
@@ -6106,9 +6124,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:

package/dist/asynchelper.yml

@@ -3323,7 +3323,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:

package/dist/connection.yml

@@ -1034,6 +1034,10 @@ paths:
         from cannot start borrowing (422 `connection_borrowed_by_another`). A
         connection can't borrow from itself: naming its own id is rejected with 422 ("… a
         connection cannot borrow concurrency from itself."), here and on `PUT`.
+        Auto-recovery never runs on `ftp` connections (FTP errors aren't treated as rate limits),
+        so on them the recovery machinery never moves `/ftp/concurrencyLevel` toward the target and
+        nothing climbs back to `/ftp/targetConcurrencyLevel`; the target still persists only while
+        `autoRecoverRateLimitErrors` is true.
         Settings-only changes are recorded in the connection's audit log.
       operationId: patchConnection
       tags:
@@ -4301,11 +4305,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
@@ -4923,6 +4929,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
@@ -4932,8 +4942,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
@@ -4964,9 +4975,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:
@@ -9652,6 +9663,7 @@ components:
             drops to 1 and climbs back toward the adaptor block's `targetConcurrencyLevel`, which is the
             throughput lever while this is on. Turning it on copies the current `concurrencyLevel` into
             the target; turning it off unsets the target and leaves `concurrencyLevel` at its current value.
+            Recovery never runs on `ftp` connections: FTP errors aren't treated as rate limits.
         __integrationIds:
           type: array
           maxItems: 100

package/dist/enduser.yml

@@ -29,7 +29,11 @@ tags:
       routes shared with workspace users. The account owner is never an end
       user: owners already have MCP access without an end-user record, the
       invite refuses the owner's address (`owner_self_invite_not_allowed`),
-      and the owner never appears in these lists.
+      and the owner never appears in these lists. Workspace administrators
+      need no record either: under Celigo OAuth they reach every MCP server in
+      the environment, and everything on it. Other workspace users need an
+      end-user record with grants. Anyone who also holds an end-user record,
+      an administrator included, is judged by that record's grants.
 
       ## End user schema
 
@@ -2358,11 +2362,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
@@ -2980,6 +2986,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
@@ -2989,8 +2999,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
@@ -3021,9 +3032,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:

package/dist/export.yml

@@ -3223,7 +3223,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
@@ -15346,7 +15348,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:
@@ -16865,7 +16869,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
@@ -16976,7 +16983,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.
@@ -17656,6 +17666,18 @@ components:
           example:
             5f7c579b6411271af4e7cefa: 64a1234567890abcdef12345
             5f7c579b6411271af4e7cefb: 64a1234567890abcdef12346
+        _stackId:
+          type: string
+          format: objectId
+          x-celigo-refModel: stacks
+          description: |-
+            Stack that every stack reference in the cloned resources (hooks and wrapper
+            connections running on a stack) points at. Required when the clone preview reports
+            `stackRequired: true`: without it the clone fails with 400 `stack_not_found`. The
+            stack must belong to the target environment or be shared with it (404
+            `stack_not_found` for an unknown id, 400 `invalid_stack` otherwise).
+          examples:
+            - 5f8d43a1b9e5a80011a35f2c
       additionalProperties: true
     CloneResponse:
       description: Response body for a clone operation. Some clone endpoints return the cloned resource, while others may return a list of related created resources.

package/dist/flow.yml

@@ -440,8 +440,10 @@ paths:
         PATCH is safer than PUT for toggling `disabled` or arming debug logging because it won't
         accidentally reset other fields. To arm debug logging, `replace` `/logging/debugUntil` with
         a future ISO timestamp (up to the plan's cap, `logging.maxDebugDuration` minutes on the license
-        from `GET /v1/licenses`); to
-        disarm, set it to a past timestamp or null.
+        from `GET /v1/licenses`). To disarm it, `remove` `/logging/debugUntil`. A `replace` with a
+        past timestamp is refused with 422 ("Debug logging end time must be in the future.") and
+        leaves the window open, so to end a window early with `replace` alone, set a time a few
+        seconds ahead.
       operationId: patchFlow
       tags:
         - Flows
@@ -475,6 +477,11 @@ paths:
                   - op: replace
                     path: /logging/debugUntil
                     value: '2026-05-02T16:00:00.000Z'
+              disable_debug:
+                summary: Turn debug logging off before the window ends
+                value:
+                  - op: remove
+                    path: /logging/debugUntil
               update_schedule:
                 summary: Change Celigo 6-field schedule cron
                 value:
@@ -1996,7 +2003,7 @@ paths:
                   value:
                     errors:
                       - code: inactive_flow
-                        message: The flow is currently disabled and cannot process retries.
+                        message: The flow is inactive. Please enable the flow before retrying.
                 missing_last_error_at:
                   summary: selectAll without lastErrorAt
                   value:
@@ -3523,7 +3530,22 @@ paths:
         '401':
           $ref: '#/components/responses/401-unauthorized'
         '404':
-          $ref: '#/components/responses/404-not-found'
+          description: |-
+            Flow not found ("The flow <_id> does not belong to the user <userId>."). The
+            same answer comes back for a flow that exists and has page generators but no page
+            processor or router yet, even when `_exportId` names one of its page generators: give it
+            a step after the export before test-running it. (An `_exportId` that isn't one of the
+            flow's page generators is the 400.)
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                not_found:
+                  summary: Unknown flow id, or a flow with no page processor or router
+                  value:
+                    errors:
+                      - message: The flow 5f8d43a1b9e5a80011a35f2c does not belong to the user 60a2c4e6f321d800129a1a3c.
         '422':
           $ref: '#/components/responses/422-unprocessable-entity'
   /v1/flows/{_id}/test/run/{runId}/{_stepId}:
@@ -4577,7 +4599,22 @@ components:
           properties:
             postResponseMap:
               type: object
-              description: Hook that runs after the step's response mapping completes.
+              description: |-
+                Hook that runs after the step's response mapping completes. The function receives
+                `options.postResponseMapData` (the records, with response mapping applied) and
+                `options.responseData` (the step's per-record results, in the same order) and returns
+                `postResponseMapData`, same length. A record an import step failed is in neither array
+                unless `proceedOnFailure` is true. Then it is included, without the fields response
+                mapping would have added, and its `responseData` entry has `statusCode` 422 and
+                `errors` as an object keyed by index (`"0"`, `"1"`, ...) rather than an array. A
+                successful entry has no `errors`.
+              x-celigo-ai-guidance:
+                - |-
+                  Verified live 2026-10-22 in flow runs of an HTTP import, three records with one
+                  answered 404: with `proceedOnFailure` unset, both arrays held the two written
+                  records; with `proceedOnFailure: true` they held all three, and a hook that called
+                  `.map` on each entry's `errors` threw on the failed one, failing the page. Read
+                  errors with `Object.values(entry.errors || {})`.
               properties:
                 function:
                   type: string
@@ -6170,6 +6207,18 @@ components:
           example:
             5f7c579b6411271af4e7cefa: 64a1234567890abcdef12345
             5f7c579b6411271af4e7cefb: 64a1234567890abcdef12346
+        _stackId:
+          type: string
+          format: objectId
+          x-celigo-refModel: stacks
+          description: |-
+            Stack that every stack reference in the cloned resources (hooks and wrapper
+            connections running on a stack) points at. Required when the clone preview reports
+            `stackRequired: true`: without it the clone fails with 400 `stack_not_found`. The
+            stack must belong to the target environment or be shared with it (404
+            `stack_not_found` for an unknown id, 400 `invalid_stack` otherwise).
+          examples:
+            - 5f8d43a1b9e5a80011a35f2c
       additionalProperties: true
     CloneResponse:
       description: Response body for a clone operation. Some clone endpoints return the cloned resource, while others may return a list of related created resources.
@@ -6227,12 +6276,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
     FlowDescendantsResponse:
@@ -6668,7 +6723,12 @@ components:
             - '500'
         message:
           type: string
-          description: Human-readable message. Frequently a JSON string that the adaptor received as a response body.
+          description: |-
+            Human-readable message. Frequently a JSON string that the adaptor received as a response body.
+            Stored cut to 500 characters: a longer message keeps its first 497 characters followed by
+            `...`. A template parse error (`handlebars_template_parse_error`) repeats the whole template
+            before its parse detail, so in a long template the detail is cut off; invoking the import
+            (`POST /v1/imports/{_id}/invoke`) with the record returns the full message.
           examples:
             - '{"error":"Internal Server Error"}'
         oIndex:

package/dist/httpconnector.yml

@@ -1613,7 +1613,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/dist/httpconnectorresource.yml

@@ -1059,7 +1059,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