@celigo/api-specs 0.2.45 → 0.2.46

package/dist/integration.yml

@@ -725,7 +725,9 @@ paths:
         '400':
           description: |-
             Revision is not in a diffable state. Error code `invalid_revision_state`. Occurs on
-            snapshot revisions (no source to diff against), `canceled` revisions (diff dropped), and
+            snapshot revisions (no source to diff against), `canceled` revisions (diff dropped),
+            `failed` revisions (read their cause from
+            `GET /v1/integrations/{_id}/revisions/{_revisionId}/errors` instead), and
             `inprogress` revisions whose install steps haven't materialized yet.
           content:
             application/json:
@@ -741,6 +743,79 @@ paths:
           $ref: '#/components/responses/401-unauthorized'
         '404':
           $ref: '#/components/responses/404-not-found'
+  /v1/integrations/{_id}/revisions/{_revisionId}/errors:
+    get:
+      x-internal: false
+      operationId: listIntegrationRevisionErrors
+      tags:
+        - Integrations
+      summary: List a failed revision's errors
+      description: |-
+        Returns the error records recorded while a `pull` or `revert` revision was being applied — the
+        same list the Revisions tab shows for a `failed` revision. Read this, not the diff, to learn why
+        a revision failed: `GET /v1/integrations/{_id}/revisions/{_revisionId}/diff` rejects `failed`
+        revisions with `invalid_revision_state`. Only `failed` revisions have error records; every
+        other state is rejected with the same `invalid_revision_state` code.
+
+        Each record names the resource the apply step rejected. Ids inside a message use the revision's
+        change-set keys: a `LifeCycleError` of the form `<type> - <id> references a deleted resource:
+        <type> - <id>.deleted` reports that the merged document still points at an entry the same change
+        set marks `.deleted`. The suffix is that marker, not the resource's state in the account — the
+        resource may still exist there.
+      parameters:
+        - name: _id
+          in: path
+          required: true
+          description: Integration id.
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: integrations
+            examples:
+              - 6842261335b64c0bcb308e4f
+        - name: _revisionId
+          in: path
+          required: true
+          description: Revision id. Must be a revision in `failed` state.
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 6a28d2af6d42eb08f8e863e7
+      responses:
+        '200':
+          description: Error records for the failed revision.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RevisionErrorsResponse'
+              examples:
+                deleted_reference:
+                  summary: Pull rejected because the merged integration references a removed lookup cache
+                  value:
+                    - _id: 6aaceb3c8b19ac878dd7cd41
+                      code: LifeCycleError
+                      message: integration - 6a90467b117405485e64787e references a deleted resource:lookupcache - 6aa912fd3ec91536bee07e41.deleted.
+                      createdAt: '2026-09-18T07:41:37.675Z'
+        '400':
+          description: |-
+            Revision is not in `failed` state, so it has no error records. Error code
+            `invalid_revision_state` — returned for `completed`, `canceled`, and `inprogress` revisions
+            of every type, including snapshots.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                invalid_revision_state:
+                  value:
+                    errors:
+                      - message: Failed to perform operation. Revision is in an invalid state
+                        code: invalid_revision_state
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
   /v1/integrations/{_id}/errors:
     get:
       x-internal: false
@@ -4515,7 +4590,7 @@ components:
           x-enumDescriptions:
             inprogress: The revision is currently being prepared and can be diffed, applied, or canceled.
             completed: The revision has been finalized and applied successfully.
-            failed: The revision encountered an error during processing.
+            failed: The apply step rejected the revision; the recorded errors are returned by `GET /v1/integrations/{_id}/revisions/{_revisionId}/errors`.
             canceled: The revision was aborted before being applied.
         description:
           type: string
@@ -4541,6 +4616,14 @@ components:
             `revert` revisions.
           examples:
             - 7d9e2b4a1c3f5068ab82d4e0fc16937255ab8c40
+        errorFileKey:
+          type: string
+          readOnly: true
+          description: |-
+            Storage key of the error file written when the apply step fails. Present only on `failed`
+            revisions; the file's records are read through `GET /v1/integrations/{_id}/revisions/{_revisionId}/errors`.
+          examples:
+            - a574f7e1294645f68e141ac6ab4eed92
         _revertToRevisionId:
           type: string
           format: objectId
@@ -4615,6 +4698,43 @@ components:
         before/after blocks. Treated as an opaque envelope here; specific field layout is not guaranteed
         stable across platform versions.
       additionalProperties: true
+    RevisionError:
+      type: object
+      description: One error recorded while a revision was being applied.
+      required:
+        - code
+        - message
+      properties:
+        _id:
+          type: string
+          format: objectId
+          description: Error record id; the Revisions tab uses it to open the record's detail view.
+          examples:
+            - 6aaceb3c8b19ac878dd7cd41
+        code:
+          type: string
+          description: Error class assigned by the apply step, such as `LifeCycleError` for change-set consistency failures.
+          examples:
+            - LifeCycleError
+        message:
+          type: string
+          description: |-
+            Human-readable cause. Resource references inside it use the change set's own ids, so a
+            `<id>.deleted` suffix identifies an entry of the revision, not the state of the resource in
+            the account.
+          examples:
+            - integration - 6a90467b117405485e64787e references a deleted resource:lookupcache - 6aa912fd3ec91536bee07e41.deleted.
+        createdAt:
+          type: string
+          format: date-time
+          description: When the error was recorded.
+          examples:
+            - '2026-09-18T07:41:37.675Z'
+    RevisionErrorsResponse:
+      type: array
+      description: Error records for one revision, oldest first.
+      items:
+        $ref: '#/components/schemas/RevisionError'
     IntegrationErrorsResponse:
       type: array
       description: |-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.45",
+  "version": "0.2.46",
   "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": "fc7b08d",
+		"iasCommit": "ddd3cac",
 		"generatedAt": "2026-09-22"
 	},
 	"roots": {