@celigo/api-specs 0.2.22 → 0.2.24

package/dist/ai-agent.yml

@@ -4958,11 +4958,6 @@ components:
         `hooks.preSavePage` script, or for a file-definition export make the repeating segment the
         record boundary in the definition's rules.
       x-celigo-ai-guidance:
-        - |-
-          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
-          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
-          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
-          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Only imports and lookups (exports placed as page processors) fan out. On a standalone export
           (a flow's page generator) the API saves ``oneToMany`` / ``pathToMany`` and applies neither:
@@ -4971,6 +4966,12 @@ components:
           the setting on the export, and as THREE child records with the same setting on the import.
           Never propose these fields as the way to split a standalone export's records; that is
           ``hooks.preSavePage`` work (or, for a file definition, the definition's record boundary).
+          The rules below apply only on a step that receives a record.
+        - |-
+          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
+          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
+          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
+          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Blank ``pathToMany`` on an OBJECT record fails every record with code ``oneToMany_error``:
           "Failed to extract child records from oneToMany import data. Record at index 0 was not an

package/dist/api.yml

@@ -3001,14 +3001,37 @@ components:
             - Customer API
             - Order Management API
         _integrationId:
-          type: string
+          type:
+            - string
+            - 'null'
           format: objectId
           x-celigo-refModel: integrations
-          description: Integration this API belongs to. Omitted for standalone APIs (an API can be created without an integration).
+          description: |-
+            Integration this API belongs to. **Builder mode only** — a script-mode
+            API is always account-level and the server silently drops this field.
+            Send `null` (or omit) to keep the API account-level; on reads the field
+            is omitted when unset, never `null`.
           examples:
             - 5e9a8f7c6b3d2a0011c4e5f6
           x-celigo-ai-guidance:
             - To move the API to a different integration, PUT with a changed _integrationId; the platform registers the API's step connections in the target integration on save.
+            - |-
+              PUT is a full replace: omitting _integrationId (or sending null) on an
+              integration-owned API moves it back to the account level and clears
+              _apiGroupingId with it.
+        _apiGroupingId:
+          type:
+            - string
+            - 'null'
+          format: objectId
+          description: |-
+            One of the owning integration's `apiGroupings`, subdividing its APIs.
+            Requires `_integrationId` in the same write — sent without it, the server
+            silently drops both — so builder mode only. `PUT /v1/apis/updateApiGrouping`
+            regroups many APIs at once; this field carries the same value on a single
+            API. On reads the field is omitted when unset, never `null`.
+          examples:
+            - 60a1b2c3d4e5f60012345678
         description:
           type: string
           description: Optional description of the API's purpose.
@@ -3208,18 +3231,6 @@ components:
               description: Unique identifier for the API.
               examples:
                 - 68ae4264b5f755d2dd3796b4
-            _apiGroupingId:
-              type:
-                - string
-                - 'null'
-              format: objectId
-              readOnly: true
-              description: |-
-                API grouping this API belongs to. Set only via
-                `PUT /apis/grouping`; the server ignores this field in POST/PUT
-                bodies on this resource. May be `null` after ungrouping.
-              examples:
-                - 60a1b2c3d4e5f60012345678
             _scriptId:
               type: string
               format: objectId

package/dist/connection.yml

@@ -927,6 +927,87 @@ paths:
           Deletes a connection permanently. This operation cannot be undone.
           The connection must not be in use by any active flows or integrations.
   /v1/connections/{_id}/ping:
+    get:
+      x-internal: false
+      summary: Ping an existing connection via GET
+      description: |-
+        GET variant of the saved-connection ping — identical behavior to
+        `POST /v1/connections/{_id}/ping`, with no request body to send. Runs the adaptor's ping
+        routine against the connection identified by `_id` to verify its credentials and network
+        configuration still work; no data is read, written, or modified.
+
+        Inspect the response body, not the HTTP status, to determine the outcome: success and
+        adaptor-level failures both return HTTP 200 — success is `{code: 200}`, failures are
+        `{errors: [...]}`. The only non-success status is 404, when `_id` does not resolve to a
+        connection.
+      operationId: pingConnectionByGet
+      tags:
+        - Connections
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: connections
+          description: Connection ID to ping.
+      responses:
+        '200':
+          description: |-
+            Ping executed. **Inspect the body** to determine outcome — success and
+            adaptor-level failures both return HTTP 200. Success returns
+            `{code: 200}`; adaptor-level failures return `{errors: [...]}`.
+          content:
+            application/json:
+              schema:
+                oneOf:
+                  - title: Ping success
+                    type: object
+                    required:
+                      - code
+                    properties:
+                      code:
+                        type: integer
+                        description: Mirrors the HTTP status — always 200 on success.
+                        example: 200
+                    additionalProperties: true
+                  - $ref: '#/components/schemas/Error'
+              examples:
+                success:
+                  summary: Connection reachable
+                  value:
+                    code: 200
+                dns_failure:
+                  summary: Connection's baseURI host could not be resolved
+                  value:
+                    errors:
+                      - code: invalid_host
+                        message: 'Unknown host: api.example.invalid. We were unable to verify this host using a DNS lookup.'
+                        source: resource
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          description: |-
+            No connection found for the given `_id`. The body is an `invalid_ref`
+            error — note this is a 404, not a 400, and the field pointer is `_id`.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                invalid_ref:
+                  value:
+                    errors:
+                      - field: _id
+                        code: invalid_ref
+                        message: unable to find connection for the given id.
+      x-celigo-ai-guidance:
+        - |-
+          Behaves identically to POST /v1/connections/{_id}/ping and takes no request body — use
+          whichever verb the client supports. Both verbs return HTTP 200 with {code: 200} on
+          success and HTTP 200 with {errors: [...]} on adaptor-level failure, so inspect the body,
+          not the status code.
     post:
       x-internal: false
       summary: Ping an existing connection

package/dist/editransaction.yml

@@ -1047,13 +1047,13 @@ components:
               - rejected
               - failed
           x-enumDescriptions:
-            inProgress: Acknowledgment is pending from the trading partner
-            notApplicable: Transaction type does not require a functional acknowledgment
-            notReceived: Acknowledgment window expired without a response
-            accepted: Trading partner accepted the transaction without errors
-            acceptedWithErrors: Trading partner accepted but reported non-fatal errors
-            rejected: Trading partner rejected the transaction entirely
-            failed: Acknowledgment processing failed due to a system error
+            inProgress: Awaiting functional acknowledgment from the trading partner.
+            notApplicable: No functional acknowledgment expected — the document is itself an FA, or the trading partner does not require one.
+            notReceived: Functional acknowledgment expected but not yet received.
+            accepted: Functional acknowledgment received and transaction was accepted.
+            acceptedWithErrors: Functional acknowledgment received with errors but transaction was accepted.
+            rejected: Functional acknowledgment received and transaction was rejected.
+            failed: Functional acknowledgment processing failed.
           description: |-
             Filter by functional acknowledgment status. Pass an array of one or
             more values to match. Must be an array, not a bare string. Omit to

package/dist/export.yml

@@ -810,11 +810,6 @@ components:
         `hooks.preSavePage` script, or for a file-definition export make the repeating segment the
         record boundary in the definition's rules.
       x-celigo-ai-guidance:
-        - |-
-          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
-          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
-          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
-          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Only imports and lookups (exports placed as page processors) fan out. On a standalone export
           (a flow's page generator) the API saves ``oneToMany`` / ``pathToMany`` and applies neither:
@@ -823,6 +818,12 @@ components:
           the setting on the export, and as THREE child records with the same setting on the import.
           Never propose these fields as the way to split a standalone export's records; that is
           ``hooks.preSavePage`` work (or, for a file definition, the definition's record boundary).
+          The rules below apply only on a step that receives a record.
+        - |-
+          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
+          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
+          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
+          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Blank ``pathToMany`` on an OBJECT record fails every record with code ``oneToMany_error``:
           "Failed to extract child records from oneToMany import data. Record at index 0 was not an
@@ -5921,10 +5922,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 +5947,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 +5972,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 +5989,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:
@@ -15517,6 +15529,8 @@ components:
                 - prepareFormData
             _scriptId:
               type: string
+              format: objectId
+              x-celigo-refModel: scripts
               description: |
                 Reference to a predefined script resource containing the initialization function.
 
@@ -15729,6 +15743,8 @@ components:
             - prepareResourceForSave
         _scriptId:
           type: string
+          format: objectId
+          x-celigo-refModel: scripts
           description: |
             Reference to a predefined script resource containing the preSave function.
 
@@ -16204,9 +16220,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 +16235,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`
 
@@ -10588,11 +10592,6 @@ components:
         `hooks.preSavePage` script, or for a file-definition export make the repeating segment the
         record boundary in the definition's rules.
       x-celigo-ai-guidance:
-        - |-
-          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
-          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
-          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
-          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Only imports and lookups (exports placed as page processors) fan out. On a standalone export
           (a flow's page generator) the API saves ``oneToMany`` / ``pathToMany`` and applies neither:
@@ -10601,6 +10600,12 @@ components:
           the setting on the export, and as THREE child records with the same setting on the import.
           Never propose these fields as the way to split a standalone export's records; that is
           ``hooks.preSavePage`` work (or, for a file definition, the definition's record boundary).
+          The rules below apply only on a step that receives a record.
+        - |-
+          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
+          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
+          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
+          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Blank ``pathToMany`` on an OBJECT record fails every record with code ``oneToMany_error``:
           "Failed to extract child records from oneToMany import data. Record at index 0 was not an
@@ -13852,6 +13857,8 @@ components:
                 - prepareFormData
             _scriptId:
               type: string
+              format: objectId
+              x-celigo-refModel: scripts
               description: |
                 Reference to a predefined script resource containing the initialization function.
 
@@ -13920,6 +13927,8 @@ components:
             - prepareResourceForSave
         _scriptId:
           type: string
+          format: objectId
+          x-celigo-refModel: scripts
           description: |
             Reference to a predefined script resource containing the preSave function.
 
@@ -14412,9 +14421,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/integration.yml

@@ -2751,6 +2751,8 @@ components:
                 - prepareFormData
             _scriptId:
               type: string
+              format: objectId
+              x-celigo-refModel: scripts
               description: |
                 Reference to a predefined script resource containing the initialization function.
 
@@ -2819,6 +2821,8 @@ components:
             - prepareResourceForSave
         _scriptId:
           type: string
+          format: objectId
+          x-celigo-refModel: scripts
           description: |
             Reference to a predefined script resource containing the preSave function.
 

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`
 
@@ -19446,11 +19450,6 @@ components:
         `hooks.preSavePage` script, or for a file-definition export make the repeating segment the
         record boundary in the definition's rules.
       x-celigo-ai-guidance:
-        - |-
-          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
-          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
-          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
-          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Only imports and lookups (exports placed as page processors) fan out. On a standalone export
           (a flow's page generator) the API saves ``oneToMany`` / ``pathToMany`` and applies neither:
@@ -19459,6 +19458,12 @@ components:
           the setting on the export, and as THREE child records with the same setting on the import.
           Never propose these fields as the way to split a standalone export's records; that is
           ``hooks.preSavePage`` work (or, for a file definition, the definition's record boundary).
+          The rules below apply only on a step that receives a record.
+        - |-
+          Two modes, decided by the SHAPE of the record entering the step. Object record with a child
+          array under a field → set ``pathToMany`` to that field. Array record (a ``groupByFields``
+          export, a CSV/file group, a script that returns an array) → leave ``pathToMany`` blank; each
+          element becomes one record. Live-verified 2026-09-10 on flows, Tools, and APIs.
         - |-
           Blank ``pathToMany`` on an OBJECT record fails every record with code ``oneToMany_error``:
           "Failed to extract child records from oneToMany import data. Record at index 0 was not an
@@ -20631,6 +20636,8 @@ components:
                 - prepareFormData
             _scriptId:
               type: string
+              format: objectId
+              x-celigo-refModel: scripts
               description: |
                 Reference to a predefined script resource containing the initialization function.
 
@@ -20699,6 +20706,8 @@ components:
             - prepareResourceForSave
         _scriptId:
           type: string
+          format: objectId
+          x-celigo-refModel: scripts
           description: |
             Reference to a predefined script resource containing the preSave function.
 
@@ -21191,9 +21200,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 +26325,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 +26350,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 +26375,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 +26392,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 +33649,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 +33664,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.24",
   "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": "9257926",
 		"generatedAt": "2026-09-18"
 	},
 	"roots": {
@@ -1629,7 +1629,8 @@
 				"object"
 			],
 			"p": {
-				"_integrationId": 1,
+				"_apiGroupingId": 88,
+				"_integrationId": 88,
 				"builder": 162,
 				"description": 1,
 				"disabled": 9,
@@ -2058,7 +2059,7 @@
 			"p": {
 				"_apiGroupingId": 88,
 				"_id": 1,
-				"_integrationId": 1,
+				"_integrationId": 88,
 				"_scriptId": 1,
 				"_templateId": 1,
 				"apim": 199,