@celigo/api-specs 0.2.161 → 0.2.163

package/dist/ai-agent.yml

@@ -1299,7 +1299,7 @@ components:
                           description: Property names the model must include in the structured output.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: When true, the structured output may include properties beyond those defined in `properties`.
                     schema:

package/dist/alert.yml

@@ -176,6 +176,8 @@ paths:
         Creates a proactive alert. Validates type, flow/integration, and duplicate
         constraints, then resolves `_recipientEmails` to `_recipientUserIds` and
         dual-writes the long-runtime threshold onto the related flow document(s).
+        A flow read doesn't return that threshold, but the flow's `lastModified`
+        moves, and the flow's own audit log gets no entry for it.
 
         Requires permission `put:alert:models`. Returns `403` when
         `ENABLE_PROACTIVE_ALERTS` is off. Response is always unpopulated.
@@ -474,7 +476,9 @@ paths:
       summary: Delete an alert
       description: |-
         Soft-deletes an alert and clears `__longRuntimeThresholdMinutes` on the
-        related flow document(s). Requires permission `put:alert:models`. Returns
+        related flow document(s), which moves each flow's `lastModified`. A
+        deleted alert reads 404 and has no recycle-bin entry. Requires permission
+        `put:alert:models`. Returns
         `403` when `ENABLE_PROACTIVE_ALERTS` is off.
       parameters:
         - name: _id

package/dist/api.yml

@@ -2967,7 +2967,13 @@ components:
       properties:
         id:
           type: string
-          description: Unique identifier for this router within the API.
+          maxLength: 36
+          pattern: ^[A-Za-z0-9_-]+$
+          description: |-
+            Unique identifier for this router within the API. Use at most 36 letters, digits,
+            underscores and hyphens: a longer id fails the save with 422 ("Router id is missing or
+            contains more than 36 characters or invalid characters. Please correct the router
+            id."), as on flow routers.
           examples:
             - router_001
             - validation_router

package/dist/export.yml

@@ -628,16 +628,19 @@ paths:
         - Exports
       summary: Invoke an export and return its data
       description: |-
-        Runs an existing export end-to-end and returns the fetched data (or errors)
+        Runs an existing export end-to-end and returns its records (or errors)
         synchronously. Unlike `POST /v1/flows/{_id}/run`, which starts a full flow
         job, this endpoint invokes a **single export** in isolation and returns the
-        raw result directly in the response body.
+        result directly in the response body.
 
         The request body is optional — pass `{}` or omit the body entirely for
         exports that require no input. Some adaptor types accept a `data` array in
         the body to supply input records.
 
-        On success, the response contains the export's fetched data. On
+        On success, the response contains the records as the export hands them
+        on: after its transform, output filter and preSavePage hook, so records
+        come back in their final shape and records the filter or hook drops aren't
+        returned. On
         application-level failure (e.g. the source system is unreachable), the
         endpoint still returns a successful HTTP status with the errors in an
         `errors` array — higher-level error codes are reserved for request-level
@@ -688,7 +691,8 @@ paths:
       responses:
         '200':
           description: |-
-            Export completed. The response contains either the fetched data or an
+            Export completed. The response contains either the export's records
+            (after its transform, output filter and preSavePage hook) or an
             `errors` array if the export encountered application-level failures
             (connection timeout, file not found, etc.). Always inspect for errors
             even on 200.
@@ -1340,11 +1344,11 @@ components:
     Once:
       type: object
       description: |-
-        Configures flag-based exports that process each record exactly once. Required when the
-        export's type is "once"; omit for other export types. Each run retrieves records where the
-        tracking boolean field is false, then sets that field to true after successful processing so
-        later runs skip them; if a run fails, the flags are left unchanged and the records are
-        retried automatically on the next run.
+        Configures flag-based exports that skip records an earlier run already processed. Required
+        when the export's type is "once"; omit for other export types. Each run retrieves records
+        where the tracking boolean field is false, then sets that field to true after successful
+        processing so later runs skip them; if a run fails, the flags are left unchanged and the
+        records are retried automatically on the next run.
       x-celigo-ai-guidance:
         - |-
           This object is REQUIRED when the export's type field is set to "once" and should
@@ -1369,7 +1373,6 @@ components:
               - One-time migrations where data should not be duplicated
               - Processing queues where records are marked as "processed"
               - Compliance scenarios requiring audit trails of exported records
-              - Implementing exactly-once delivery semantics
         - |-
           4. Error handling behavior:
               - If the export fails, the boolean fields remain unchanged
@@ -16523,6 +16526,8 @@ components:
           description: |-
             Custom JavaScript hooks that run at fixed points in the export lifecycle for
             transformations, validation, and filtering beyond what configuration alone can express.
+            A hook name not listed here (an import's `preMap`, for example) is dropped on save
+            without an error, so read `hooks` back after saving.
           properties:
             preSavePage:
               type: object

package/dist/flow.yml

@@ -4780,11 +4780,17 @@ components:
       properties:
         id:
           type: string
+          maxLength: 36
+          pattern: ^[A-Za-z0-9_-]+$
           description: |
             Unique identifier for this router within the flow.
 
             Used to reference this router from branches (`branches[].nextRouterId`)
             when chaining routers. Must be unique within the flow's router collection.
+            Use at most 36 letters, digits, underscores and hyphens: a longer id, or one
+            with a space or a period, fails the save with 422 ("Router id is missing or
+            contains more than 36 characters or invalid characters. Please correct the
+            router id.").
           examples:
             - router_001
             - customer_type_router

package/dist/guardrail.yml

@@ -997,7 +997,7 @@ components:
                           description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:

package/dist/iclient.yml

@@ -318,8 +318,9 @@ paths:
       x-internal: false
       summary: Update an iClient
       description: |-
-        Replaces an iClient. All mutable fields must be provided — omitted
-        fields are reset to defaults. Secrets returned as `"******"` can be
+        Replaces an existing iClient; create one with `POST /v1/iclients`. All
+        mutable fields must be provided — omitted fields are reset to defaults.
+        Secrets returned as `"******"` can be
         sent back as-is to keep the existing value, except a Google service
         account: every update must include the full JSON key. An Azure
         service principal keeps its stored `clientSecret` or `certificate`

package/dist/import.yml

@@ -9681,7 +9681,7 @@ components:
                           description: Property names the model must include in the structured output.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: When true, the structured output may include properties beyond those defined in `properties`.
                     schema:
@@ -11072,7 +11072,7 @@ components:
                           description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:

package/dist/integration.yml

@@ -340,8 +340,8 @@ paths:
         - Integrations
       description: |-
         Deletes an integration. The integration is soft-deleted and retained in the
-        recycle bin for 30 days before permanent removal. Delete the APIs and Tools it
-        contains, and remove its aliases that point at lookup caches, first.
+        recycle bin for 30 days before permanent removal. Delete the flows, syncs, APIs and
+        Tools it contains, and remove its aliases that point at lookup caches, first.
       parameters:
         - name: _id
           in: path
@@ -364,12 +364,26 @@ paths:
           description: |-
             The integration still contains resources that must be deleted first, APIs and Tools
             among them (`dependencies_not_deleted`, one entry per blocking resource), or one of its
-            `aliases[]` still points at a lookup cache.
+            `aliases[]` still points at a lookup cache. Flows and syncs block it the same way, with
+            one entry per flow or sync still in the integration ("flow <id> must be deleted before
+            you can delete integration <id>", "sync <id> must be deleted before you can delete
+            integration <id>"), and nothing is deleted.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
               examples:
+                flows_remaining:
+                  summary: The integration still holds flows
+                  value:
+                    errors:
+                      - message: flow <flowId> must be deleted before you can delete integration <integrationId>
+                      - message: flow <secondFlowId> must be deleted before you can delete integration <integrationId>
+                syncs_remaining:
+                  summary: The integration still holds a sync
+                  value:
+                    errors:
+                      - message: sync <syncId> must be deleted before you can delete integration <integrationId>
                 lookup_cache_alias:
                   value:
                     errors:

package/dist/notification.yml

@@ -149,8 +149,9 @@ paths:
         '200':
           description: |-
             Per-item result array (parallel to the request). Each entry is
-            `{statusCode, errors?}` — `statusCode: 200` on success, or a non-200
-            status with an `errors[]` array on per-item failures. Overall HTTP is
+            `{statusCode, errors?}` — `statusCode` 201 for a created subscription
+            and 200 for one that already existed or was removed, or a 4xx status
+            with an `errors[]` array on per-item failures. Overall HTTP is
             still 200 even when individual items fail.
           content:
             application/json:
@@ -163,12 +164,13 @@ paths:
                     statusCode:
                       type: integer
                       description: |-
-                        Per-item outcome: 200 when the subscription was created,
-                        updated, or left unchanged; 422 when the referenced
-                        resource doesn't exist (details in `errors[]`).
+                        Per-item outcome: 201 when the subscription was created;
+                        200 when it already existed (subscribing again keeps the one
+                        record) or was removed; 422 when the referenced resource
+                        doesn't exist (details in `errors[]`).
                     errors:
                       type: array
-                      description: Per-item error details — present on non-200 results.
+                      description: Per-item error details — present on 4xx per-item failures, never on a 201 or 200.
                       items:
                         type: object
                         properties:
@@ -186,9 +188,9 @@ paths:
                               - Please ensure that connection with 000000000000000000000001 exists for creating the notification.
               examples:
                 allSuccess:
-                  summary: All items applied cleanly
+                  summary: A new subscription and one that already existed
                   value:
-                    - statusCode: 200
+                    - statusCode: 201
                     - statusCode: 200
                 mixed:
                   summary: One item referenced a non-existent connection

package/dist/recyclebin.yml

@@ -419,7 +419,9 @@ paths:
         Resources are auto-purged after 30 days. A purge removes only the
         named resource: purge the bin entries that still reference it first
         (a deleted flow references its integration and the exports and imports
-        it used).
+        it used). An integration's Celigo Storage system folder is the
+        exception: the folder and everything in it go to the bin with the
+        integration and are purged with it.
       parameters:
         - $ref: '#/components/parameters/ResourceType'
         - name: _id

package/dist/tool.yml

@@ -6674,10 +6674,15 @@ components:
       properties:
         id:
           type: string
+          maxLength: 36
+          pattern: ^[A-Za-z0-9_-]+$
           description: |
             Unique identifier for this router within the tool.
 
             Used to reference this router from other routers' branch `nextRouterId`.
+            Use at most 36 letters, digits, underscores and hyphens: a longer id fails
+            the save with 422 ("Router id is missing or contains more than 36 characters
+            or invalid characters. Please correct the router id."), as on flow routers.
           examples:
             - router_001
             - validation_router
@@ -21189,7 +21194,7 @@ components:
                           description: Property names the model must include in the structured output.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: When true, the structured output may include properties beyond those defined in `properties`.
                     schema:
@@ -22580,7 +22585,7 @@ components:
                           description: Property names the stored JSON Schema marks as required.
                           items:
                             type: string
-                        additionalproperties:
+                        additionalProperties:
                           type: boolean
                           description: Whether the stored JSON Schema allows properties beyond those in `properties`.
                     schema:
@@ -26440,11 +26445,11 @@ components:
     Once:
       type: object
       description: |-
-        Configures flag-based exports that process each record exactly once. Required when the
-        export's type is "once"; omit for other export types. Each run retrieves records where the
-        tracking boolean field is false, then sets that field to true after successful processing so
-        later runs skip them; if a run fails, the flags are left unchanged and the records are
-        retried automatically on the next run.
+        Configures flag-based exports that skip records an earlier run already processed. Required
+        when the export's type is "once"; omit for other export types. Each run retrieves records
+        where the tracking boolean field is false, then sets that field to true after successful
+        processing so later runs skip them; if a run fails, the flags are left unchanged and the
+        records are retried automatically on the next run.
       x-celigo-ai-guidance:
         - |-
           This object is REQUIRED when the export's type field is set to "once" and should
@@ -26469,7 +26474,6 @@ components:
               - One-time migrations where data should not be duplicated
               - Processing queues where records are marked as "processed"
               - Compliance scenarios requiring audit trails of exported records
-              - Implementing exactly-once delivery semantics
         - |-
           4. Error handling behavior:
               - If the export fails, the boolean fields remain unchanged
@@ -37703,6 +37707,8 @@ components:
           description: |-
             Custom JavaScript hooks that run at fixed points in the export lifecycle for
             transformations, validation, and filtering beyond what configuration alone can express.
+            A hook name not listed here (an import's `preMap`, for example) is dropped on save
+            without an error, so read `hooks` back after saving.
           properties:
             preSavePage:
               type: object

package/package.json

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