@celigo/api-specs 0.2.202 → 0.2.204

package/dist/tool.yml

@@ -1241,8 +1241,8 @@ paths:
         '422':
           description: |-
             A step failed, or the Tool was refused before any step ran: a connection binding is
-            missing (`connection_not_overridden`) or has no `_id`, its branches don't all merge
-            back (`tool_dangling_branch`), or the input fails `input.schema` (a missing `required`
+            missing (`connection_not_overridden`), its branches don't all merge back
+            (`tool_dangling_branch`), or the input fails `input.schema` (a missing `required`
             property answers `tool_input_schema_validation_failed`). The output stage answers 422 too when the stored
             `output.schema` holds `additionalProperties: false` and the output mappings write a field
             it doesn't list ("Tool output validation failed: must NOT have additional properties").
@@ -1250,6 +1250,14 @@ paths:
             `proceedOnFailure: true`: the later steps still run, but the response carries the error,
             not the output. Either way the response includes `invocationId` when logging is active,
             so the run can be opened in the run history.
+
+            Once the Tool is found and has steps, a malformed `overrides` block is refused with
+            `invalid_override` ("Invalid override at <path>. <reason>") before any step runs:
+            `overrides` is not an object, a `connections`/`exports`/`imports`/`routers` value is not
+            an array or holds a non-object entry, a connection binding has no `_abstractId`, names
+            none of `_id`, `_borrowConcurrencyFromConnectionId`, or `requiresEndUserCredentials`, or
+            sets both `_id` and `_borrowConcurrencyFromConnectionId`. These refusals carry only `code`
+            and `message`, and no `invocationId` even with `x-log-mode: debug`.
           content:
             application/json:
               schema:
@@ -1259,7 +1267,7 @@ paths:
                 properties:
                   errors:
                     type: array
-                    description: Execution errors, each with a `code`, `message`, `source`, and epoch-millisecond `time`.
+                    description: Execution errors, each with a `code`, `message`, `source`, and epoch-millisecond `time`. An `invalid_override` refusal has only `code` and `message`.
                     items:
                       type: object
                       additionalProperties: true
@@ -1280,10 +1288,23 @@ paths:
                         message: 'Missing connection overrides. The following connection IDs must be overridden: 6ab1f5657b3d01a9084253a5.'
                     invocationId: 6ab1f5877cd5cdd66da1cc8b
                 binding_without_id:
-                  summary: A connection binding without `_id`
+                  summary: A connection binding with only `_abstractId`
+                  value:
+                    errors:
+                      - code: invalid_override
+                        message: 'Invalid override at overrides.connections[0]. Connection override must include at least one of: _id, _borrowConcurrencyFromConnectionId, requiresEndUserCredentials.'
+                binding_without_abstract_id:
+                  summary: A connection binding without `_abstractId`
+                  value:
+                    errors:
+                      - code: invalid_override
+                        message: Invalid override at overrides.connections[0]._abstractId. Missing required _abstractId.
+                overrides_not_object:
+                  summary: '`overrides` sent as an array'
                   value:
                     errors:
-                      - message: 'Invalid override at overrides.connections[0]. Connection override must include at least one of: _id, _borrowConcurrencyFromConnectionId, requiresEndUserCredentials.'
+                      - code: invalid_override
+                        message: Invalid override at overrides. Expected overrides to be an object.
   /v1/tools/{_id}/invocations:
     get:
       x-internal: false
@@ -1895,12 +1916,14 @@ paths:
         not landed yet; re-query before concluding nothing was stored.
 
         For nested Tools, set `stage` to `tool` with the nested ToolImport id to fetch the
-        composed input/output payload.
+        composed input/output payload; `groupId` is not needed for that stage and is ignored.
+        Until the nested Tool's payloads land, that entry carries only `_expOrImpId` and `stage`.
 
         When the invocation is missing or not visible under the caller's integration ACL,
         the endpoint returns `204 No Content`. `404` applies only to an unknown or inaccessible
-        Tool `_id`. A malformed `executionId` returns `422`, and a body missing any of the four
-        selector keys returns `400`. Sandbox Tools return `403`.
+        Tool `_id`. A malformed `executionId` returns `422`, and a body missing a required
+        selector key (`groupId` is required for every stage except `tool`) returns `400`.
+        Sandbox Tools return `403`.
       parameters:
         - name: _id
           in: path
@@ -1947,7 +1970,6 @@ paths:
                 value:
                   _expOrImpId: 67ee026136f4d1eeb529ad63
                   stage: tool
-                  groupId: g-12345
                   recordId: r-67890
       responses:
         '200':
@@ -2012,6 +2034,21 @@ paths:
                               content-type: application/json; charset=utf-8
                             body: '[{"_id":"6a50f177a8d85436a4a890db","name":"SO-1043"}]'
                     errors: []
+                nestedToolStage:
+                  summary: Nested Tool composed payload — the record it received and the record it returned
+                  value:
+                    logs:
+                      - log:
+                          _expOrImpId: 67ee026136f4d1eeb529ad63
+                          stage: tool
+                          input:
+                            record:
+                              orderId: SO-1043
+                          output:
+                            record:
+                              orderId: SO-1043
+                              title: Sample Slide Show
+                    errors: []
                 noMatch:
                   summary: Selector matched no stored payload
                   value:
@@ -31247,7 +31284,8 @@ components:
               description: |-
                 Provider-native ID of the storage root (e.g. a Google Drive shared-drive ID) the relative
                 path resolves against; set when pathMode is relativePath. The provider's own ID, not a Celigo ID.
-                For Google Cloud Storage it is the bucket name.
+                For Google Cloud Storage it is the bucket name, and a bucket that doesn't exist fails the
+                export preview with 422 `gcs_bucket_not_found`.
               examples:
                 - 1qU1hvFarBFMb4-twqKm1rR5o_6j9vs9g
                 - erp-exports
@@ -39498,8 +39536,15 @@ components:
       required:
         - _expOrImpId
         - stage
-        - groupId
         - recordId
+      if:
+        properties:
+          stage:
+            not:
+              const: tool
+      then:
+        required:
+          - groupId
       properties:
         _expOrImpId:
           type: string
@@ -39526,7 +39571,7 @@ components:
             - tool
         groupId:
           type: string
-          description: Group identifier of the step record.
+          description: Group identifier of the step record. Ignored when `stage` is `tool`.
           examples:
             - YYFuqOqC
         recordId:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.202",
+  "version": "0.2.204",
   "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": "4a026a0b",
+		"iasCommit": "bbd50898",
 		"generatedAt": "2026-10-28"
 	},
 	"roots": {