@celigo/api-specs 0.2.22 → 0.2.23

package/dist/export.yml

@@ -5921,10 +5921,10 @@ components:
             - blob
             - csvstream
           x-enumDescriptions:
-            file: Treats the HTTP response as raw file content (PDFs, images, binary data) rather than structured data records.
+            file: Works with files instead of a record endpoint — a raw file download (PDFs, images, binary data), or a file-provider folder whose files the file object parses into records (csv, json, xml, xlsx, filedefinition incl. EDI)
             blob: Transfers the raw response body downstream as a blob without parsing it into records.
             csvstream: Streams a large CSV response, parsing it row-by-row instead of loading the whole body into memory.
-          description: Set to `file` only when the endpoint returns raw file content (PDFs, images, binary data) to be saved as a file rather than parsed as records; the `file` object must also be configured. Leave undefined for standard data exports that return structured records (JSON, XML, GraphQL, SOAP responses) — the response is then parsed into records for downstream steps. When set to `file` or `blob`, the export appears as a "Transfer" step in Flow Builder instead of a standard "Export" step.
+          description: 'Set to `file` when the export works with files rather than a record-returning endpoint: raw file downloads (PDFs, images, binary data) and the folder mode of the cloud file providers (Google Drive, Box, Dropbox, Azure Blob, Google Cloud Storage, Celigo Storage), where each file in the folder is parsed by the `file` object''s `type` (csv, json, xml, xlsx, filedefinition — including EDI) into records; the `file` object must also be configured. Leave undefined for standard data exports that return structured records (JSON, XML, GraphQL, SOAP responses) — the response is then parsed into records for downstream steps. When set to `file` or `blob`, the export appears as a "Transfer" step in Flow Builder instead of a standard "Export" step.'
           x-celigo-ai-guidance:
             - |-
               ## IMPORTANT: This field should be LEFT UNDEFINED for the vast majority of HTTP exports.
@@ -5946,18 +5946,24 @@ components:
               - "Export all Shopify Customers" → undefined (returns JSON customer records)
               - "Retrieve orders from custom REST API" → undefined (returns JSON order records)
             - |-
-              ## WHEN TO SET THIS FIELD TO 'file' (RARE USE CASE):
+              ## WHEN TO SET THIS FIELD TO 'file' (the export works with FILES, not a record endpoint):
 
-              Set this field to 'file' ONLY when the HTTP endpoint is specifically designed to download files:
-              - The endpoint returns raw binary file content (PDFs, images, ZIP files, etc.)
-              - The endpoint is a file download service (e.g., downloading invoices, reports, attachments)
-              - The response body contains file data that needs to be saved as a file, not parsed as records
-              - You need to download and process files from a remote server
+              Set this field to 'file' in two situations:
+              - The HTTP endpoint is specifically designed to download files — it returns raw binary
+                file content (PDFs, images, ZIP files) or is a file download service (invoices,
+                reports, attachments) whose body is saved as a file rather than parsed as records
+              - The connection is a cloud file provider used in FOLDER mode (Google Drive, Box, Dropbox,
+                Azure Blob Storage, Google Cloud Storage, Celigo Storage): the export reads the files
+                in a folder and the 'file' object's `type` (csv, json, xml, xlsx, filedefinition)
+                parses each one into records — the same file layer as an FTP or S3 export
 
               Examples of when to set type: "file":
               - "Download PDF invoices from the API" → type: "file"
               - "Retrieve image files from a file server" → type: "file"
-              - "Download CSV files from an FTP server via HTTP" → type: "file"
+              - "Read the CSV files dropped in our Google Drive folder" → type: "file", with file.type "csv"
+              - "Parse EDI X12 850 files from a Google Drive / Celigo Storage folder" → type: "file",
+                with file.type "filedefinition" and a top-level _ediProfileId (EDI fields are
+                accepted on HTTP exports only in file mode)
             - |-
               ## IMPLEMENTATION DETAILS
 
@@ -5965,7 +5971,9 @@ components:
               - The 'file' object property MUST also be configured
               - The export appears as a "Transfer" step in the Flow Builder UI
               - The system applies file-specific processing to the HTTP response
-              - Downstream steps receive file content rather than record data
+              - Downstream steps receive records when the 'file' object's `type` parses the files
+                (csv, json, xml, xlsx, filedefinition with `file.output: "records"`), or the file
+                content itself when `file.output` is "blobKeys"
 
               When this field is undefined (default for most exports):
               - The export appears as a standard "Export" step in the Flow Builder UI
@@ -5980,6 +5988,9 @@ components:
                  → YES: Leave this field undefined
               3. Does the API endpoint return raw file content (PDFs, images, binary data)?
                  → YES: Set this field to "file" (and configure the 'file' property)
+              4. Is the connection a cloud file provider and the export reads a FOLDER of files
+                 (CSV, JSON, XML, XLSX, or EDI via a file definition)?
+                 → YES: Set this field to "file" (and configure the 'file' property with the parsing type)
 
               Remember: When in doubt, leave this field undefined. Most HTTP exports are standard data exports.
           examples:
@@ -16204,9 +16215,12 @@ components:
           format: objectId
           x-celigo-refModel: ediprofiles
           description: |-
-            EDI profile this export uses to parse incoming X12 EDI documents into structured JSON —
-            it supplies the envelope qualifiers, delimiters, version, and validation rules. Set it
-            when the export parses or validates EDI files; omit it otherwise.
+            EDI profile this export uses to parse incoming X12 or EDIFACT documents into structured
+            JSON — it supplies the envelope qualifiers, delimiters, version, and validation rules.
+            Set it when the export parses or validates EDI files; omit it otherwise. Accepted on the
+            file-reading exports — FTP, AS2, S3 and HTTP file mode (`http.type: "file"`).
+          x-celigo-ai-guidance:
+            - 'An HTTP export accepts this field only in file mode (`http.type: "file"`, the folder mode of file-provider connectors such as Google Drive, Box, Dropbox, Azure Blob, Google Cloud Storage and Celigo Storage). On a REST/records HTTP export the save is rejected with `not_supported`: "EDIProfile can only be associated with the export of type FTP, AS2, S3 or HTTP file."'
           examples:
             - 60a2c4e6f321d800129a1a3c
         _postParseListenerId:
@@ -16216,8 +16230,10 @@ components:
           description: |-
             Webhook export invoked once per file after EDI parsing, on both success and failure
             (errors are included in the payload when parsing fails). Primarily used to send
-            functional acknowledgements (997/999) to trading partners. Only supported for
-            `AS2Export` and `FTPExport` parsing EDI files.
+            functional acknowledgements (997/999) to trading partners. Accepted on the file-reading
+            exports that parse EDI — FTP, AS2, S3 and HTTP file mode (`http.type: "file"`).
+          x-celigo-ai-guidance:
+            - 'The listener must be an export with `type: "webhook"` and `webhook.provider: "integrator-extension"`; any other export id is rejected with `invalid_post_parse_listener`. On an HTTP export outside file mode the save is rejected with `post_parse_listener_not_supported`: "Listener for functional acknowledgment is only supported for AS2, FTP, S3 and HTTP file export."'
           examples:
             - 60a2c4e6f321d800129a1a3c
         externalId:

package/dist/import.yml

@@ -8247,11 +8247,15 @@ components:
         - `S3Import`
         - `FTPImport`
         - `AS2Import`
+        - `HTTPImport` in file mode (`http.type: "file"` — the folder mode of the cloud file
+          providers such as Google Drive, Box, Dropbox, Azure Blob, Google Cloud Storage and Celigo
+          Storage); the same `file` object, including `type: filedefinition` with `_ediProfileId`
+          for EDI, applies as on S3 / FTP
 
         ❌ **DO NOT SET** for non-file-based imports like:
         - `SalesforceImport`
         - `NetSuiteImport`
-        - `HTTPImport`
+        - `HTTPImport` in records mode (`http.type` unset — a REST endpoint receiving records)
         - `MongodbImport`
         - `RDBMSImport`
 
@@ -14412,9 +14416,12 @@ components:
           format: objectId
           x-celigo-refModel: ediprofiles
           description: |-
-            EDI profile this import uses to generate outbound X12 EDI documents — it supplies the
-            envelope qualifiers, delimiters, version, and validation rules. Set it when the import
-            produces EDI output; omit it otherwise.
+            EDI profile this import uses to generate outbound X12 or EDIFACT documents — it supplies
+            the envelope qualifiers, delimiters, version, and validation rules. Set it when the
+            import produces EDI output; omit it otherwise. Accepted on the file-writing imports —
+            FTP, AS2, S3 and HTTP file mode (`http.type: "file"`).
+          x-celigo-ai-guidance:
+            - 'On an HTTP import set `http.type: "file"` (the folder mode of file-provider connectors) and pair this field with `file.type: "filedefinition"` and `file.skipAggregation: true` or `file.aggregation.type: "key"` — the platform saves EDI files per page or per key, never aggregated per run.'
         parsers:
           type: array
           description: |-

package/dist/tool.yml

@@ -17105,11 +17105,15 @@ components:
         - `S3Import`
         - `FTPImport`
         - `AS2Import`
+        - `HTTPImport` in file mode (`http.type: "file"` — the folder mode of the cloud file
+          providers such as Google Drive, Box, Dropbox, Azure Blob, Google Cloud Storage and Celigo
+          Storage); the same `file` object, including `type: filedefinition` with `_ediProfileId`
+          for EDI, applies as on S3 / FTP
 
         ❌ **DO NOT SET** for non-file-based imports like:
         - `SalesforceImport`
         - `NetSuiteImport`
-        - `HTTPImport`
+        - `HTTPImport` in records mode (`http.type` unset — a REST endpoint receiving records)
         - `MongodbImport`
         - `RDBMSImport`
 
@@ -21191,9 +21195,12 @@ components:
           format: objectId
           x-celigo-refModel: ediprofiles
           description: |-
-            EDI profile this import uses to generate outbound X12 EDI documents — it supplies the
-            envelope qualifiers, delimiters, version, and validation rules. Set it when the import
-            produces EDI output; omit it otherwise.
+            EDI profile this import uses to generate outbound X12 or EDIFACT documents — it supplies
+            the envelope qualifiers, delimiters, version, and validation rules. Set it when the
+            import produces EDI output; omit it otherwise. Accepted on the file-writing imports —
+            FTP, AS2, S3 and HTTP file mode (`http.type: "file"`).
+          x-celigo-ai-guidance:
+            - 'On an HTTP import set `http.type: "file"` (the folder mode of file-provider connectors) and pair this field with `file.type: "filedefinition"` and `file.skipAggregation: true` or `file.aggregation.type: "key"` — the platform saves EDI files per page or per key, never aggregated per run.'
         parsers:
           type: array
           description: |-
@@ -26313,10 +26320,10 @@ components:
             - blob
             - csvstream
           x-enumDescriptions:
-            file: Treats the HTTP response as raw file content (PDFs, images, binary data) rather than structured data records.
+            file: Works with files instead of a record endpoint — a raw file download (PDFs, images, binary data), or a file-provider folder whose files the file object parses into records (csv, json, xml, xlsx, filedefinition incl. EDI)
             blob: Transfers the raw response body downstream as a blob without parsing it into records.
             csvstream: Streams a large CSV response, parsing it row-by-row instead of loading the whole body into memory.
-          description: Set to `file` only when the endpoint returns raw file content (PDFs, images, binary data) to be saved as a file rather than parsed as records; the `file` object must also be configured. Leave undefined for standard data exports that return structured records (JSON, XML, GraphQL, SOAP responses) — the response is then parsed into records for downstream steps. When set to `file` or `blob`, the export appears as a "Transfer" step in Flow Builder instead of a standard "Export" step.
+          description: 'Set to `file` when the export works with files rather than a record-returning endpoint: raw file downloads (PDFs, images, binary data) and the folder mode of the cloud file providers (Google Drive, Box, Dropbox, Azure Blob, Google Cloud Storage, Celigo Storage), where each file in the folder is parsed by the `file` object''s `type` (csv, json, xml, xlsx, filedefinition — including EDI) into records; the `file` object must also be configured. Leave undefined for standard data exports that return structured records (JSON, XML, GraphQL, SOAP responses) — the response is then parsed into records for downstream steps. When set to `file` or `blob`, the export appears as a "Transfer" step in Flow Builder instead of a standard "Export" step.'
           x-celigo-ai-guidance:
             - |-
               ## IMPORTANT: This field should be LEFT UNDEFINED for the vast majority of HTTP exports.
@@ -26338,18 +26345,24 @@ components:
               - "Export all Shopify Customers" → undefined (returns JSON customer records)
               - "Retrieve orders from custom REST API" → undefined (returns JSON order records)
             - |-
-              ## WHEN TO SET THIS FIELD TO 'file' (RARE USE CASE):
+              ## WHEN TO SET THIS FIELD TO 'file' (the export works with FILES, not a record endpoint):
 
-              Set this field to 'file' ONLY when the HTTP endpoint is specifically designed to download files:
-              - The endpoint returns raw binary file content (PDFs, images, ZIP files, etc.)
-              - The endpoint is a file download service (e.g., downloading invoices, reports, attachments)
-              - The response body contains file data that needs to be saved as a file, not parsed as records
-              - You need to download and process files from a remote server
+              Set this field to 'file' in two situations:
+              - The HTTP endpoint is specifically designed to download files — it returns raw binary
+                file content (PDFs, images, ZIP files) or is a file download service (invoices,
+                reports, attachments) whose body is saved as a file rather than parsed as records
+              - The connection is a cloud file provider used in FOLDER mode (Google Drive, Box, Dropbox,
+                Azure Blob Storage, Google Cloud Storage, Celigo Storage): the export reads the files
+                in a folder and the 'file' object's `type` (csv, json, xml, xlsx, filedefinition)
+                parses each one into records — the same file layer as an FTP or S3 export
 
               Examples of when to set type: "file":
               - "Download PDF invoices from the API" → type: "file"
               - "Retrieve image files from a file server" → type: "file"
-              - "Download CSV files from an FTP server via HTTP" → type: "file"
+              - "Read the CSV files dropped in our Google Drive folder" → type: "file", with file.type "csv"
+              - "Parse EDI X12 850 files from a Google Drive / Celigo Storage folder" → type: "file",
+                with file.type "filedefinition" and a top-level _ediProfileId (EDI fields are
+                accepted on HTTP exports only in file mode)
             - |-
               ## IMPLEMENTATION DETAILS
 
@@ -26357,7 +26370,9 @@ components:
               - The 'file' object property MUST also be configured
               - The export appears as a "Transfer" step in the Flow Builder UI
               - The system applies file-specific processing to the HTTP response
-              - Downstream steps receive file content rather than record data
+              - Downstream steps receive records when the 'file' object's `type` parses the files
+                (csv, json, xml, xlsx, filedefinition with `file.output: "records"`), or the file
+                content itself when `file.output` is "blobKeys"
 
               When this field is undefined (default for most exports):
               - The export appears as a standard "Export" step in the Flow Builder UI
@@ -26372,6 +26387,9 @@ components:
                  → YES: Leave this field undefined
               3. Does the API endpoint return raw file content (PDFs, images, binary data)?
                  → YES: Set this field to "file" (and configure the 'file' property)
+              4. Is the connection a cloud file provider and the export reads a FOLDER of files
+                 (CSV, JSON, XML, XLSX, or EDI via a file definition)?
+                 → YES: Set this field to "file" (and configure the 'file' property with the parsing type)
 
               Remember: When in doubt, leave this field undefined. Most HTTP exports are standard data exports.
           examples:
@@ -33626,9 +33644,12 @@ components:
           format: objectId
           x-celigo-refModel: ediprofiles
           description: |-
-            EDI profile this export uses to parse incoming X12 EDI documents into structured JSON —
-            it supplies the envelope qualifiers, delimiters, version, and validation rules. Set it
-            when the export parses or validates EDI files; omit it otherwise.
+            EDI profile this export uses to parse incoming X12 or EDIFACT documents into structured
+            JSON — it supplies the envelope qualifiers, delimiters, version, and validation rules.
+            Set it when the export parses or validates EDI files; omit it otherwise. Accepted on the
+            file-reading exports — FTP, AS2, S3 and HTTP file mode (`http.type: "file"`).
+          x-celigo-ai-guidance:
+            - 'An HTTP export accepts this field only in file mode (`http.type: "file"`, the folder mode of file-provider connectors such as Google Drive, Box, Dropbox, Azure Blob, Google Cloud Storage and Celigo Storage). On a REST/records HTTP export the save is rejected with `not_supported`: "EDIProfile can only be associated with the export of type FTP, AS2, S3 or HTTP file."'
           examples:
             - 60a2c4e6f321d800129a1a3c
         _postParseListenerId:
@@ -33638,8 +33659,10 @@ components:
           description: |-
             Webhook export invoked once per file after EDI parsing, on both success and failure
             (errors are included in the payload when parsing fails). Primarily used to send
-            functional acknowledgements (997/999) to trading partners. Only supported for
-            `AS2Export` and `FTPExport` parsing EDI files.
+            functional acknowledgements (997/999) to trading partners. Accepted on the file-reading
+            exports that parse EDI — FTP, AS2, S3 and HTTP file mode (`http.type: "file"`).
+          x-celigo-ai-guidance:
+            - 'The listener must be an export with `type: "webhook"` and `webhook.provider: "integrator-extension"`; any other export id is rejected with `invalid_post_parse_listener`. On an HTTP export outside file mode the save is rejected with `post_parse_listener_not_supported`: "Listener for functional acknowledgment is only supported for AS2, FTP, S3 and HTTP file export."'
           examples:
             - 60a2c4e6f321d800129a1a3c
         externalId:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.22",
+  "version": "0.2.23",
   "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": "c51aefb",
+		"iasCommit": "ed5e198",
 		"generatedAt": "2026-09-18"
 	},
 	"roots": {