@celigo/api-specs 0.2.228 → 0.2.230

package/dist/api.yml

@@ -8124,16 +8124,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     PGP:
       type: object
       description: |-
@@ -8346,7 +8361,13 @@ components:
                 rest: REST connection driven by a pre-built HTTP Connector template. Deprecated — use `http` instead.
             externalId:
               type: string
-              description: External identifier for the connection, often used for integration with third-party systems
+              description: |-
+                External identifier for the connection, often used to correlate it with a record in a
+                third-party system. On a connection inside an Integration App tile (`_connectorId` set)
+                it is the app's own stamp on the connections its install created (`shopify_connection`,
+                …), and the platform refuses the DELETE of a tile connection that carries it or
+                `_sourceId`; a tile connection with neither was added by a user and deletes normally.
+                The name lock on tile connections follows `_connectorId`, not this field.
               examples:
                 - erp-conn-001
             assistant:

package/dist/asynchelper.yml

@@ -3703,16 +3703,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     AsyncHelper:
       type: object
       required:

package/dist/connection.yml

@@ -3936,16 +3936,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     PGP:
       type: object
       description: |-
@@ -4158,7 +4173,13 @@ components:
                 rest: REST connection driven by a pre-built HTTP Connector template. Deprecated — use `http` instead.
             externalId:
               type: string
-              description: External identifier for the connection, often used for integration with third-party systems
+              description: |-
+                External identifier for the connection, often used to correlate it with a record in a
+                third-party system. On a connection inside an Integration App tile (`_connectorId` set)
+                it is the app's own stamp on the connections its install created (`shopify_connection`,
+                …), and the platform refuses the DELETE of a tile connection that carries it or
+                `_sourceId`; a tile connection with neither was added by a user and deletes normally.
+                The name lock on tile connections follows `_connectorId`, not this field.
               examples:
                 - erp-conn-001
             assistant:
@@ -9790,7 +9811,13 @@ components:
             rest: REST connection driven by a pre-built HTTP Connector template. Deprecated — use `http` instead.
         externalId:
           type: string
-          description: External identifier for the connection, often used to correlate it with a record in a third-party system.
+          description: |-
+            External identifier for the connection, often used to correlate it with a record in a
+            third-party system. On a connection inside an Integration App tile (`_connectorId` set)
+            it is the app's own stamp on the connections its install created (`shopify_connection`,
+            …), and the platform refuses the DELETE of a tile connection that carries it or
+            `_sourceId`; a tile connection with neither was added by a user and deletes normally.
+            The name lock on tile connections follows `_connectorId`, not this field.
           examples:
             - erp-conn-001
         assistant:

package/dist/enduser.yml

@@ -1961,16 +1961,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     PGP:
       type: object
       description: |-
@@ -2183,7 +2198,13 @@ components:
                 rest: REST connection driven by a pre-built HTTP Connector template. Deprecated — use `http` instead.
             externalId:
               type: string
-              description: External identifier for the connection, often used for integration with third-party systems
+              description: |-
+                External identifier for the connection, often used to correlate it with a record in a
+                third-party system. On a connection inside an Integration App tile (`_connectorId` set)
+                it is the app's own stamp on the connections its install created (`shopify_connection`,
+                …), and the platform refuses the DELETE of a tile connection that carries it or
+                `_sourceId`; a tile connection with neither was added by a user and deletes normally.
+                The name lock on tile connections follows `_connectorId`, not this field.
               examples:
                 - erp-conn-001
             assistant:

package/dist/export.yml

@@ -17559,16 +17559,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     AIDescription:
       type: object
       description: |

package/dist/flow.yml

@@ -6284,7 +6284,9 @@ components:
               description: |-
                 Integration App connector that owns this flow. Assigned by the connector
                 framework at install time — user creates that set it are rejected with 403
-                `create_not_allowed`.
+                `create_not_allowed`, and a DELETE of a flow carrying it answers 403
+                `delete_not_allowed` — the flow goes away with the uninstall of the store,
+                account or app it belongs to.
               examples:
                 - 60a2c4e6f321d800129a1a3c
             lastExecutedAt:

package/dist/guardrail.yml

@@ -525,16 +525,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     McpResources:
       type: array
       description: |-

package/dist/iclient.yml

@@ -4212,16 +4212,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     iClient:
       type: object
       required:

package/dist/import.yml

@@ -4504,6 +4504,29 @@ components:
                               addresses the current line with the same
                               `<array>[*].<field>` path — see
                               `netsuite_da.lookups[].expression`.
+                            - |-
+                              A Handlebars `extract` addresses the current line with
+                              the same `<array>[*].<field>` path — in a substitution,
+                              as a helper argument
+                              (`{{multiply line_items[*].tax_lines.[0].rate 100}}`)
+                              and as a block-helper argument
+                              (`{{#if line_items[*].taxable}}5973{{/if}}`). The row
+                              is evaluated once per line and drives the iteration by
+                              itself; the mapping preview
+                              (`PUT /v1/netsuiteDA/previewImportMappingFields`) renders
+                              every form per line, including the block-helper form it
+                              cannot evaluate in a lookup `expression`. An empty render
+                              is sent as an empty value unless `discardIfEmpty` omits
+                              the field; in the preview, a sublist whose only row renders
+                              empty for a line omits that line from the output, while
+                              beside another line row the line is returned with the
+                              empty value. An
+                              arithmetic helper on a line that lacks the field renders
+                              `NaN`, so guard it on the object the helper reads
+                              (`{{#if line_items[*].tax_lines.[0]}}…{{/if}}`), not on
+                              the number: `#if` treats a real `0` rate as empty.
+                              The same expression on a body row (`fields[]`) renders
+                              the first line's value only.
                         generate:
                           type: string
                           description: |-
@@ -4916,7 +4939,7 @@ components:
                     for the field: $.<path>` — and resolves to `default` when
                     `allowFailures` is true.
                   - |-
-                    ## The mapping preview cannot evaluate `[*]` inside a block-helper argument
+                    ## The mapping preview cannot evaluate `[*]` inside a block-helper argument of a lookup expression
 
                     `PUT /v1/netsuiteDA/previewImportMappingFields` (the mapping
                     editor's Preview) evaluates lookups for real — resolved
@@ -4924,14 +4947,17 @@ components:
                     compile errors in `data.mappingErrors[]` — and handles
                     `[*]` in plain substitutions and inside a branch's output.
                     It does NOT apply the per-line evaluation to `[*]` used as a
-                    block-helper ARGUMENT (`{{#if line_items[*].x}}`,
+                    block-helper ARGUMENT of a lookup expression (`{{#if line_items[*].x}}`,
                     `{{#contains line_items[*].sku "_"}}`): the sublist comes
                     back EMPTY with no error, whatever the expression would do
                     in a run. An empty preview is therefore no evidence about
-                    such an expression — never report it as "renders nothing"
+                    such a lookup expression — never report it as "renders nothing"
                     or as invalid on that basis; validate it with a run.
                     `<array>.@index.<field>` is likewise not evaluable in the
                     preview (the record is dropped with no error).
+                    A mapping row's `extract` with the same block-helper shape IS
+                    rendered per line by the preview — see
+                    `netsuite_da.mapping.lists[].fields[].extract`.
               operator:
                 type: string
                 description: |-
@@ -18038,16 +18064,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     AIDescription:
       type: object
       description: |

package/dist/integration.yml

@@ -3516,6 +3516,8 @@ components:
             - 5b3c8f9a2e1d4c0011223344
           description: |-
             Integration App (connector) identifier when this integration is based on an installed Integration App.
+            An integration carrying it is a tile (or a child of one) and is uninstalled from its Admin →
+            Uninstall page, never deleted: a DELETE answers 403 `delete_not_allowed`.
 
             If you are not working with an Integration App installation, omit this field.
         _templateId:

package/dist/mcp-server.yml

@@ -5009,16 +5009,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     PGP:
       type: object
       description: |-
@@ -5231,7 +5246,13 @@ components:
                 rest: REST connection driven by a pre-built HTTP Connector template. Deprecated — use `http` instead.
             externalId:
               type: string
-              description: External identifier for the connection, often used for integration with third-party systems
+              description: |-
+                External identifier for the connection, often used to correlate it with a record in a
+                third-party system. On a connection inside an Integration App tile (`_connectorId` set)
+                it is the app's own stamp on the connections its install created (`shopify_connection`,
+                …), and the platform refuses the DELETE of a tile connection that carries it or
+                `_sourceId`; a tile connection with neither was added by a user and deletes normally.
+                The name lock on tile connections follows `_connectorId`, not this field.
               examples:
                 - erp-conn-001
             assistant:

package/dist/tool.yml

@@ -7548,16 +7548,31 @@ components:
           x-celigo-refModel: connectors
           readOnly: true
           description: |-
-            Integration App (connector) that defines this resource. Present only on resources an
-            Integration App owns. The app locks parts of these documents, and a PUT that changes a
-            locked field answers 200 but keeps the stored value, so read the document back to confirm
-            a change.
+            Integration App (connector) whose tile this resource lives in. Set on every resource
+            inside the tile — the app's own flows, steps and the connections its install created,
+            and also a connection a user added inside the tile. The app locks parts of
+            these documents: a PUT that changes a locked field answers 200 but keeps the stored
+            value, so read the document back to confirm a change, while a PATCH to a locked field
+            (a connection's `name`) answers 422 `field_locked_by_integration_app`. A DELETE answers
+            403 `delete_not_allowed` for every resource carrying this field except a connection
+            with neither `externalId` nor `_sourceId` — one a user added inside the tile; the app's
+            own resources go away with the uninstall of the store, account or app they belong to.
           examples:
             - 5e8d43a1b9e5a80011a35f1b
           x-celigo-ai-guidance:
             - |-
-              Read-only connector (Integration App template) reference; present only on
-              connector-owned resources. Never set or modify it when authoring resources.
+              Read-only connector (Integration App template) reference, stamped by the platform on
+              every resource in the app's tile. Never set or modify it when authoring resources.
+            - |-
+              Never stage a DELETE of a resource carrying this field unless it is a connection with
+              neither `externalId` nor `_sourceId` (one a user added inside the tile, which deletes
+              normally): the platform refuses every other DELETE with 403 `delete_not_allowed` —
+              "Cannot delete a resource that belongs to an Integration App." Hand over the Admin →
+              Uninstall page of the store, account or app the resource belongs to instead.
+            - |-
+              Never stage a rename of a connection carrying this field — a user-added one included:
+              `PATCH /name` answers 422 `field_locked_by_integration_app` — "Field: /name belongs to
+              an Integration App and is locked."
     PGP:
       type: object
       description: |-
@@ -7713,7 +7728,13 @@ components:
                 rest: REST connection driven by a pre-built HTTP Connector template. Deprecated — use `http` instead.
             externalId:
               type: string
-              description: External identifier for the connection, often used for integration with third-party systems
+              description: |-
+                External identifier for the connection, often used to correlate it with a record in a
+                third-party system. On a connection inside an Integration App tile (`_connectorId` set)
+                it is the app's own stamp on the connections its install created (`shopify_connection`,
+                …), and the platform refuses the DELETE of a tile connection that carries it or
+                `_sourceId`; a tile connection with neither was added by a user and deletes normally.
+                The name lock on tile connections follows `_connectorId`, not this field.
               examples:
                 - erp-conn-001
             assistant:
@@ -16802,6 +16823,29 @@ components:
                               addresses the current line with the same
                               `<array>[*].<field>` path — see
                               `netsuite_da.lookups[].expression`.
+                            - |-
+                              A Handlebars `extract` addresses the current line with
+                              the same `<array>[*].<field>` path — in a substitution,
+                              as a helper argument
+                              (`{{multiply line_items[*].tax_lines.[0].rate 100}}`)
+                              and as a block-helper argument
+                              (`{{#if line_items[*].taxable}}5973{{/if}}`). The row
+                              is evaluated once per line and drives the iteration by
+                              itself; the mapping preview
+                              (`PUT /v1/netsuiteDA/previewImportMappingFields`) renders
+                              every form per line, including the block-helper form it
+                              cannot evaluate in a lookup `expression`. An empty render
+                              is sent as an empty value unless `discardIfEmpty` omits
+                              the field; in the preview, a sublist whose only row renders
+                              empty for a line omits that line from the output, while
+                              beside another line row the line is returned with the
+                              empty value. An
+                              arithmetic helper on a line that lacks the field renders
+                              `NaN`, so guard it on the object the helper reads
+                              (`{{#if line_items[*].tax_lines.[0]}}…{{/if}}`), not on
+                              the number: `#if` treats a real `0` rate as empty.
+                              The same expression on a body row (`fields[]`) renders
+                              the first line's value only.
                         generate:
                           type: string
                           description: |-
@@ -17214,7 +17258,7 @@ components:
                     for the field: $.<path>` — and resolves to `default` when
                     `allowFailures` is true.
                   - |-
-                    ## The mapping preview cannot evaluate `[*]` inside a block-helper argument
+                    ## The mapping preview cannot evaluate `[*]` inside a block-helper argument of a lookup expression
 
                     `PUT /v1/netsuiteDA/previewImportMappingFields` (the mapping
                     editor's Preview) evaluates lookups for real — resolved
@@ -17222,14 +17266,17 @@ components:
                     compile errors in `data.mappingErrors[]` — and handles
                     `[*]` in plain substitutions and inside a branch's output.
                     It does NOT apply the per-line evaluation to `[*]` used as a
-                    block-helper ARGUMENT (`{{#if line_items[*].x}}`,
+                    block-helper ARGUMENT of a lookup expression (`{{#if line_items[*].x}}`,
                     `{{#contains line_items[*].sku "_"}}`): the sublist comes
                     back EMPTY with no error, whatever the expression would do
                     in a run. An empty preview is therefore no evidence about
-                    such an expression — never report it as "renders nothing"
+                    such a lookup expression — never report it as "renders nothing"
                     or as invalid on that basis; validate it with a run.
                     `<array>.@index.<field>` is likewise not evaluable in the
                     preview (the record is dropped with no error).
+                    A mapping row's `extract` with the same block-helper shape IS
+                    rendered per line by the preview — see
+                    `netsuite_da.mapping.lists[].fields[].extract`.
               operator:
                 type: string
                 description: |-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.228",
+  "version": "0.2.230",
   "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": "55c3cdcf",
+		"iasCommit": "358107cf",
 		"generatedAt": "2026-11-04"
 	},
 	"roots": {