@celigo/api-specs 0.2.77 → 0.2.78

package/dist/import.yml

@@ -8400,6 +8400,19 @@ components:
             - 100
     File:
       type: object
+      x-celigo-excludeAdaptorTypes:
+        - RDBMSImport
+        - JDBCImport
+        - SalesforceImport
+        - NetSuiteImport
+        - MongodbImport
+      x-celigo-ai-guidance:
+        - |-
+          Never author or patch `file` on an `RDBMSImport`. On a bulk load the API echoes a
+          platform-derived `file` object whose values a save cannot change: the write is accepted,
+          the change is discarded, and a read-back shows the original values. Shape the records
+          before the write (a preMap/postMap hook, the mapping, a transform) or correct the source
+          data instead.
       description: |-
         **CRITICAL: This object is REQUIRED for all file-based import adaptor types.**
 
@@ -8420,6 +8433,17 @@ components:
         - `HTTPImport` in records mode (`http.type` unset — a REST endpoint receiving records)
         - `MongodbImport`
         - `RDBMSImport`
+        - `JDBCImport`
+
+        **Read-only on database bulk loads**
+
+        An `RDBMSImport` whose `rdbms.queryType` is `bulk_load` returns a `file` object anyway: the
+        platform's description of the staging file it generates for the load (delimiter, quoting,
+        newline handling, and how the load is batched into files). It is derived on every read,
+        never stored — a save that changes it is accepted and the change discarded (the audit log
+        still records the request), and the import editor has no control for it. Change what
+        reaches the destination with a preMap/postMap hook, the mapping, or a transform, or correct
+        the source data.
 
         **Minimum required fields**
 

package/dist/tool.yml

@@ -18798,6 +18798,19 @@ components:
             - 100
     File:
       type: object
+      x-celigo-excludeAdaptorTypes:
+        - RDBMSImport
+        - JDBCImport
+        - SalesforceImport
+        - NetSuiteImport
+        - MongodbImport
+      x-celigo-ai-guidance:
+        - |-
+          Never author or patch `file` on an `RDBMSImport`. On a bulk load the API echoes a
+          platform-derived `file` object whose values a save cannot change: the write is accepted,
+          the change is discarded, and a read-back shows the original values. Shape the records
+          before the write (a preMap/postMap hook, the mapping, a transform) or correct the source
+          data instead.
       description: |-
         **CRITICAL: This object is REQUIRED for all file-based import adaptor types.**
 
@@ -18818,6 +18831,17 @@ components:
         - `HTTPImport` in records mode (`http.type` unset — a REST endpoint receiving records)
         - `MongodbImport`
         - `RDBMSImport`
+        - `JDBCImport`
+
+        **Read-only on database bulk loads**
+
+        An `RDBMSImport` whose `rdbms.queryType` is `bulk_load` returns a `file` object anyway: the
+        platform's description of the staging file it generates for the load (delimiter, quoting,
+        newline handling, and how the load is batched into files). It is derived on every read,
+        never stored — a save that changes it is accepted and the change discarded (the audit log
+        still records the request), and the import editor has no control for it. Change what
+        reaches the destination with a preMap/postMap hook, the mapping, or a transform, or correct
+        the source data.
 
         **Minimum required fields**
 

package/package.json

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

package/schemas.json

@@ -1,8 +1,8 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "2fa4fd0",
-		"generatedAt": "2026-10-06"
+		"iasCommit": "72d3caa",
+		"generatedAt": "2026-10-07"
 	},
 	"roots": {
 		"aiagent": 133,