@celigo/api-specs 0.2.12 → 0.2.14

package/dist/integration.yml

@@ -1474,6 +1474,26 @@ paths:
       description: |-
         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.
+      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
+          used by the integration. Please ensure no integration resource is using the
+          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
@@ -1498,6 +1518,28 @@ paths:
       responses:
         '204':
           description: Connection unregistered successfully. No body returned.
+        '400':
+          description: |-
+            A resource in the integration still uses the connection -- a flow, Tool, or API
+            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:
+                $ref: '#/components/schemas/Error'
+              examples:
+                in_use:
+                  value:
+                    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.12",
+  "version": "0.2.14",
   "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": "69a5baf",
+		"iasCommit": "62a17aa",
 		"generatedAt": "2026-09-12"
 	},
 	"roots": {