@celigo/api-specs 0.2.13 → 0.2.15

package/dist/integration.yml

@@ -1475,23 +1475,27 @@ paths:
         Removes a connection's registration from the integration. This does not delete the connection
         itself -- it only removes it from the integration's registered-connections list.
 
-        Fails while any resource in the integration still uses the connection -- a step
-        (export, import, or lookup) in one of its flows, Tools, or APIs bound to it through
-        `_connectionId`, or an alias on the integration or one of its flows whose
-        `_connectionId` points at it. Move the steps to another connection first (a whole flow
-        at once with `PUT /v1/flows/{_id}/replaceConnection`; Tool and API steps through their
-        own step-level `replaceConnection`), remove any alias that still points at it, then
-        unregister.
+        Fails while any resource in the integration still uses the connection. Two references
+        are known to count: any step in one of its flows, Tools, or APIs whose `_connectionId`
+        is this connection -- every step is an export or import document, whatever its kind
+        (lookup, listener, AI agent, guardrail, Tool wrapper, transfer) -- and an alias on the
+        integration or one of its flows whose `_connectionId` points at it. Move the steps to
+        another connection first (a whole flow at once with
+        `PUT /v1/flows/{_id}/replaceConnection`; Tool and API steps through their own
+        step-level `replaceConnection`), remove or retarget any alias that still points at it,
+        then unregister.
       x-celigo-ai-guidance:
         - |-
           Before calling, list what the integration still binds to this connection: the
           `_connectionId` of every export and import in the integration
           (`GET /v1/integrations/{_id}/exports` and `/imports` cover flow, Tool, and API
           steps) and every `aliases[]._connectionId` on the integration and its flows. While
-          any remain the platform returns 400 `not_allowed` ("The connection is being actively
+          any remain the platform returns 400 `not_allowed` -- "The connection is being actively
           used by the integration. Please ensure no integration resource is using the
-          connection before deregistering."). `replaceConnection` moves steps; it does not
-          rewrite aliases -- update the `aliases` array on the integration or flow.
+          connection before deregistering." for a bound step, "This connection is being
+          referenced by an alias. Delete the alias before deregistering the connection." for
+          an alias. Aliases are separate from step bindings: retarget or remove the matching
+          `aliases` entries on the integration or flow as their own write.
       parameters:
         - name: _id
           in: path
@@ -1519,8 +1523,10 @@ paths:
         '400':
           description: |-
             A resource in the integration still uses the connection -- a flow, Tool, or API
-            step bound to it, or an alias on the integration or one of its flows that points at
-            it. Error code: `not_allowed`.
+            step bound to it ("The connection is being actively used by the integration..."),
+            or an alias on the integration or one of its flows that points at it ("This
+            connection is being referenced by an alias. Delete the alias before deregistering
+            the connection."). Error code: `not_allowed` for both.
           content:
             application/json:
               schema:
@@ -1531,6 +1537,11 @@ paths:
                     errors:
                       - code: not_allowed
                         message: The connection is being actively used by the integration. Please ensure no integration resource is using the connection before deregistering.
+                alias_referenced:
+                  value:
+                    errors:
+                      - code: not_allowed
+                        message: This connection is being referenced by an alias. Delete the alias before deregistering the connection.
         '401':
           $ref: '#/components/responses/401-unauthorized'
         '404':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "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": "c4ad952",
+		"iasCommit": "89fae90",
 		"generatedAt": "2026-09-12"
 	},
 	"roots": {