@celigo/api-specs 0.2.85 → 0.2.87

package/dist/filestorage.yml

@@ -1658,6 +1658,11 @@ paths:
                 summary: Move to the account root
                 value:
                   _parentId: null
+              renameOnMove:
+                summary: Move into a folder and rename to avoid a collision
+                value:
+                  _parentId: 684c3b1f2d4e6g002b0h9c34
+                  name: inv-001 (1).pdf
       responses:
         '200':
           description: |-
@@ -1695,6 +1700,23 @@ paths:
                       x-celigo-refModel: storageitems
                     examples:
                       - - 684c3b1f2d4e6g002b0h9c34
+                  _integrationId:
+                    type:
+                      - string
+                      - 'null'
+                    format: objectId
+                    x-celigo-refModel: integrations
+                    description: |-
+                      The item's integration after the move — the destination's
+                      integration when it landed inside an integration's system
+                      folder tree, null when it landed outside one.
+                    examples:
+                      - 6ab1e7ab38d7733b4594d0d2
+                  name:
+                    type: string
+                    description: Name of the moved item.
+                    examples:
+                      - inv-001.pdf
               examples:
                 default:
                   value:
@@ -1702,6 +1724,8 @@ paths:
                     _parentId: 684c3b1f2d4e6g002b0h9c34
                     __ancestorIds:
                       - 684c3b1f2d4e6g002b0h9c34
+                    _integrationId: null
+                    name: inv-001.pdf
         '400':
           $ref: '#/components/responses/400-bad-request'
         '401':
@@ -2150,9 +2174,9 @@ paths:
       x-internal: false
       summary: Get storage usage by environment
       description: |-
-        Returns the same account-wide totals as `GET /v1/storage/usage`, broken
-        down per environment. Use it to see which environment is consuming the
-        account's shared quota.
+        Returns storage usage per environment, with the account-wide total and
+        the quota figures `GET /v1/storage/usage` reports. Use it to see which
+        environment is consuming the account's shared quota.
       operationId: getStorageUsageByEnvironment
       tags:
         - File Storage
@@ -2177,18 +2201,18 @@ paths:
                 default:
                   value:
                     environments:
-                      - _envUserId: 60a1b2c3d4e5f6001a2b3c4d
-                        name: Production
+                      - environment:
+                          _id: 60a1b2c3d4e5f6001a2b3c4d
+                          name: Production
                         activeUsage: 429496729
                         recycleBinUsage: 52428800
                         totalUsage: 481925529
-                      - _envUserId: 60a1b2c3d4e5f6001a2b3c4e
-                        name: Sandbox
+                      - environment:
+                          _id: 60a1b2c3d4e5f6001a2b3c4e
+                          name: Sandbox
                         activeUsage: 107374182
                         recycleBinUsage: 52428800
                         totalUsage: 159802982
-                    activeUsage: 536870912
-                    recycleBinUsage: 104857600
                     totalUsage: 641728512
                     maxAllowedUsage: 1073741824
                     isOverage: false
@@ -2831,6 +2855,19 @@ components:
                   type: string
                   format: objectId
                   x-celigo-refModel: storageitems
+              _integrationId:
+                type:
+                  - string
+                  - 'null'
+                format: objectId
+                x-celigo-refModel: integrations
+                description: |-
+                  The item's integration after the move — the destination's
+                  integration when it landed inside an integration's system folder
+                  tree, null when it landed outside one. Present on success.
+              name:
+                type: string
+                description: Name of the moved item (the new name when `name` was sent). Present on success.
               type:
                 type: string
                 enum:
@@ -2970,6 +3007,15 @@ components:
             the item itself or one of its descendants.
           examples:
             - 684c3b1f2d4e6g002b0h9c34
+        name:
+          type: string
+          maxLength: 256
+          description: |-
+            New name applied to the item in the same write as the re-parent, so
+            a name already taken in the destination can be resolved without a
+            second call. Omit to keep the current name.
+          examples:
+            - inv-001 (1).pdf
     CopyRequest:
       type: object
       description: Request body for copying a file.
@@ -3192,22 +3238,31 @@ components:
       type: object
       description: Storage usage for a single environment.
       required:
-        - _envUserId
+        - environment
         - activeUsage
         - recycleBinUsage
         - totalUsage
       properties:
-        _envUserId:
-          type: string
-          format: objectId
-          description: Environment user ID this breakdown belongs to.
-          examples:
-            - 60a1b2c3d4e5f6001a2b3c4d
-        name:
-          type: string
-          description: Environment name, such as Production or Sandbox.
-          examples:
-            - Production
+        environment:
+          type: object
+          description: Environment the usage belongs to.
+          required:
+            - _id
+            - name
+          properties:
+            _id:
+              type: string
+              format: objectId
+              x-celigo-refModel: environments
+              description: Environment id, as returned by `GET /v1/environments`.
+              examples:
+                - 60a1b2c3d4e5f6001a2b3c4d
+            name:
+              type: string
+              description: Environment display name.
+              examples:
+                - Production
+                - Sandbox
         activeUsage:
           type: integer
           format: int64
@@ -3229,12 +3284,12 @@ components:
     UsageEnvironments:
       type: object
       description: |-
-        Per-environment usage breakdown alongside the same account-wide totals
-        returned by `GET /v1/storage/usage`.
+        Per-environment usage breakdown alongside the account-wide quota
+        figures returned by `GET /v1/storage/usage`. The active / recycle-bin
+        split is reported per environment; the account-wide total is the sum
+        of the rows.
       required:
         - environments
-        - activeUsage
-        - recycleBinUsage
         - totalUsage
         - maxAllowedUsage
         - isOverage
@@ -3246,22 +3301,10 @@ components:
           description: One entry per environment in the account.
           items:
             $ref: '#/components/schemas/EnvironmentUsage'
-        activeUsage:
-          type: integer
-          format: int64
-          description: Account-wide bytes consumed by active and pending files.
-          examples:
-            - 536870912
-        recycleBinUsage:
-          type: integer
-          format: int64
-          description: Account-wide bytes consumed by soft-deleted files.
-          examples:
-            - 104857600
         totalUsage:
           type: integer
           format: int64
-          description: Account-wide sum of activeUsage and recycleBinUsage.
+          description: Account-wide bytes consumed by active, pending and soft-deleted files across every environment.
           examples:
             - 641728512
         systemUsage:

package/dist/integration.yml

@@ -25,7 +25,9 @@ tags:
       - **Standard integrations** — user-created containers that group custom flows.
       - **Integration App installations** — created from a published connector/template,
         with install/uninstall steps, settings forms, editions, and optional child
-        integrations. These have `_connectorId` and `_templateId` set.
+        integrations. `_connectorId` is what identifies one. The wizard fields (`mode`,
+        `install`, `installSteps`) also appear on a standard integration created by the
+        UI's clone-and-install, so they do not by themselves mean Integration App.
 
       Integrations support **Integration Lifecycle Management (ILM)**: clone an integration
       across environments, then use revisions (snapshot, pull, revert) to promote changes
@@ -99,8 +101,10 @@ paths:
       summary: Create an integration
       description: |-
         Creates a new integration. Only `name` is required — the server populates all other
-        fields with defaults. Do not include Integration App fields (`_connectorId`, `_templateId`,
-        `install`, `installSteps`, etc.) unless you are creating an IA installation.
+        fields with defaults. Do not include `_connectorId` unless you are creating an
+        Integration App installation, or `_templateId` unless the integration is created from
+        a template; leave the install-wizard fields (`mode`, `install`, `installSteps`) to the
+        platform's installers.
       operationId: createIntegration
       tags:
         - Integrations
@@ -3418,16 +3422,18 @@ components:
           examples:
             - 5c1a7b8d4f2e6a0011556677
           description: |-
-            Template identifier used to create/initialize this integration (commonly for Integration Apps).
+            Marketplace template this integration was installed from. Absent on integrations built from scratch and on
+            clones. It does not make the integration an Integration App — `_connectorId` does.
 
             Omit unless you are creating/updating an integration from a template.
         install:
           type: array
           description: |-
-            Install "cards" shown during an Integration App installation.
+            Install "cards" an Integration App installer shows during installation — UI workflow metadata, not runtime
+            configuration. The platform also writes it (empty) on a plain custom integration created by the UI's
+            clone-and-install, so its presence does not indicate an Integration App.
 
-            These are primarily UI/workflow metadata. Unless you are explicitly modeling an Integration App install experience,
-            omit this field.
+            Unless you are explicitly modeling an install experience, omit this field.
           items:
             type: object
             additionalProperties: true
@@ -3502,17 +3508,19 @@ components:
         mode:
           type: string
           description: |-
-            Integration App lifecycle mode.
+            Where the integration stands in its install or uninstall wizard. The platform writes it on a plain custom
+            integration created by the UI's clone-and-install as much as on an Integration App, and leaves it set after
+            the wizard completes, so it does not indicate an Integration App (`_connectorId` does).
 
-            Use this only when dealing with Integration App lifecycle workflows.
+            Omit when creating an integration directly.
           enum:
             - install
             - settings
             - uninstall
           x-enumDescriptions:
-            install: The integration is being installed or is in the install workflow.
-            settings: The integration is in settings configuration mode.
-            uninstall: The integration is being uninstalled.
+            install: Install steps are still pending and the UI shows the setup wizard
+            settings: Setup is complete and the integration is in normal use
+            uninstall: The integration is being uninstalled
           examples:
             - install
         settings:
@@ -3634,9 +3642,12 @@ components:
         installSteps:
           type: array
           description: |-
-            Ordered list of lifecycle steps used by the Integration App installer.
+            Ordered steps of the install wizard that created this integration, each marked completed as it finishes.
+            Written by the UI's clone-and-install of a plain custom integration (a `template_zip` step with `isClone`
+            true) as well as by Integration App installers, and kept after completion — so a populated list does not
+            indicate an Integration App.
 
-            This is primarily Integration App workflow metadata. Omit unless you are working with Integration Apps.
+            Omit unless you are building an installer.
           items:
             type: object
             additionalProperties: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.85",
+  "version": "0.2.87",
   "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": "9f42828",
-		"generatedAt": "2026-10-10"
+		"iasCommit": "b2082d3",
+		"generatedAt": "2026-10-11"
 	},
 	"roots": {
 		"aiagent": 133,