@celigo/api-specs 0.2.98 → 0.2.99

package/dist/flow.yml

@@ -3813,15 +3813,15 @@ paths:
               preview_import_step:
                 summary: Preview the import step of a one-generator flow
                 value:
-                  flowDoc:
+                  flow:
                     name: 'Accounts: HubSpot to NetSuite'
                     pageGenerators:
                       - _exportId: 652583cf9085040ecbf54303
                     pageProcessors:
                       - type: import
                         _importId: 6508ab8b20b16404da729c64
+                    _selectedPageGeneratorId: 652583cf9085040ecbf54303
                   _pageProcessorId: 6508ab8b20b16404da729c64
-                  _selectedPageGeneratorId: 652583cf9085040ecbf54303
                   pageGeneratorMap:
                     652583cf9085040ecbf54303:
                       doc:
@@ -7796,12 +7796,17 @@ components:
             match keys in the side-loaded maps. Full flow doc shape mirrors
             `POST /v1/flows` body. Accepted under key `flow` despite the
             server's stale `flowDoc` error message.
-          additionalProperties: true
-        flowDoc:
-          type: object
-          description: |-
-            Alias for `flow` — the server appears to accept either key.
-            Prefer `flow`.
+          properties:
+            _selectedPageGeneratorId:
+              type: string
+              format: objectId
+              x-celigo-refModel: exports
+              description: |-
+                Page generator to drive the preview when the flow has multiple.
+                Defaults to `pageGenerators[0]._exportId`. Set it inside `flow`: the
+                server ignores a top-level `_selectedPageGeneratorId`.
+              examples:
+                - 61f92026dd053843b5d72350
           additionalProperties: true
         _pageProcessorId:
           type: string
@@ -7811,14 +7816,6 @@ components:
             in `pageProcessorMap`.
           examples:
             - 64a1234567890abcdef12345
-        _selectedPageGeneratorId:
-          type: string
-          format: objectId
-          description: |-
-            Page generator to drive the preview when the flow has multiple.
-            Defaults to `flow.pageGenerators[0]._exportId`.
-          examples:
-            - 61f92026dd053843b5d72350
         pageGeneratorMap:
           type: object
           description: |-
@@ -7891,7 +7888,7 @@ components:
             the response carries the records the target would receive as input
             (for a lookup step, with its `responseMapping` already merged in).
       required:
-        - flowDoc
+        - flow
         - _pageProcessorId
         - pageGeneratorMap
         - pageProcessorMap

package/dist/marketplace.yml

@@ -48,12 +48,14 @@ paths:
         an integration or an MCP server and therefore which install route to
         call. Entries have no `docType`.
 
-        The whole catalog is returned in one response, sorted by `name` unless
-        `sort_by` says otherwise. Templates that reference an application no
+        Results are sorted by `name` unless `sort_by` says otherwise, and the
+        list may be paginated: follow the `Link` header's `rel="next"` URL until
+        the header is absent. Templates that reference an application no
         longer available on the platform are left out, so this list can be
         shorter than the `docType: Template` subset of
         `POST /v1/published/combined`.
       parameters:
+        - $ref: '#/components/parameters/After'
         - name: sort_by
           in: query
           required: false
@@ -74,6 +76,14 @@ paths:
       responses:
         '200':
           description: Array of Template marketplace entries.
+          headers:
+            Link:
+              description: |-
+                RFC 5988 pagination links. When more pages remain, includes a
+                `<...>; rel="next"` entry with an `after` cursor; absent on the
+                final page.
+              schema:
+                type: string
           content:
             application/json:
               schema:
@@ -110,7 +120,7 @@ paths:
         '204':
           description: No published templates are available.
         '400':
-          description: '`sort_by` is not one of the accepted keys.'
+          description: '`sort_by` is not one of the accepted keys, or `after` is not a valid pagination cursor.'
           content:
             application/json:
               schema:
@@ -121,6 +131,11 @@ paths:
                     errors:
                       - code: invalid_query_param
                         message: The query parameter "sort_by" has invalid value.
+                invalidCursor:
+                  value:
+                    errors:
+                      - code: invalid_query_param
+                        message: Please provide a valid cursor(i.e after or before query param) to encode or decode.
         '401':
           $ref: '#/components/responses/401-unauthorized'
   /v1/templates/{_id}/preview:
@@ -256,9 +271,22 @@ paths:
         use `POST /v1/published/combined` instead. Entries here have no
         `docType` field -- that discriminator only appears in the combined
         endpoint's response.
+
+        The list may be paginated: follow the `Link` header's `rel="next"` URL
+        until the header is absent.
+      parameters:
+        - $ref: '#/components/parameters/After'
       responses:
         '200':
           description: Array of Integration App (Connector) marketplace entries.
+          headers:
+            Link:
+              description: |-
+                RFC 5988 pagination links. When more pages remain, includes a
+                `<...>; rel="next"` entry with an `after` cursor; absent on the
+                final page.
+              schema:
+                type: string
           content:
             application/json:
               schema:
@@ -283,6 +311,18 @@ paths:
                       trialEnabled: false
                       lastModified: '2026-04-22T14:23:56.528Z'
                       numInstalls: 1938
+        '400':
+          description: '`after` is not a valid pagination cursor.'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                invalidCursor:
+                  value:
+                    errors:
+                      - code: invalid_query_param
+                        message: Please provide a valid cursor(i.e after or before query param) to encode or decode.
         '401':
           $ref: '#/components/responses/401-unauthorized'
   /v1/published/combined:
@@ -293,11 +333,12 @@ paths:
         - Marketplace
       summary: List Integration Apps and Templates together
       description: |-
-        Returns a unified array of **all** marketplace content — both Integration
+        Returns a unified array of marketplace content — both Integration
         Apps (`docType: Connector`) and Templates (`docType: Template`). Each
         entry carries the `docType` discriminator so callers can partition, and
         every Template entry also carries `type` (`integration` or `mcpserver`),
-        which decides its install route.
+        which decides its install route. The list may be paginated: follow the
+        `Link` header's `rel="next"` URL until the header is absent.
 
         Despite being a POST, this is a **read-only, safe** endpoint — the body
         is an empty `{}` in the default CLI invocation. POST is used purely to
@@ -308,6 +349,7 @@ paths:
         the body. For Connector-only listings, `GET /v1/published` is
         lighter.
       parameters:
+        - $ref: '#/components/parameters/After'
         - name: sort_by
           in: query
           required: false
@@ -342,6 +384,14 @@ paths:
       responses:
         '200':
           description: Array of marketplace entries, both Connectors and Templates.
+          headers:
+            Link:
+              description: |-
+                RFC 5988 pagination links. When more pages remain, includes a
+                `<...>; rel="next"` entry with an `after` cursor; absent on the
+                final page.
+              schema:
+                type: string
           content:
             application/json:
               schema:
@@ -380,7 +430,7 @@ paths:
         '400':
           description: |-
             Typically `invalid_query_param` when `sort_by` is outside the
-            accepted enum.
+            accepted enum or `after` is not a valid pagination cursor.
           content:
             application/json:
               schema:
@@ -391,6 +441,11 @@ paths:
                     errors:
                       - code: invalid_query_param
                         message: The query parameter "sort_by" has invalid value.
+                invalidCursor:
+                  value:
+                    errors:
+                      - code: invalid_query_param
+                        message: Please provide a valid cursor(i.e after or before query param) to encode or decode.
         '401':
           $ref: '#/components/responses/401-unauthorized'
         '415':
@@ -413,6 +468,16 @@ components:
     bearerAuth:
       type: http
       scheme: bearer
+  parameters:
+    After:
+      name: after
+      in: query
+      required: false
+      description: |-
+        Opaque cursor for forward pagination. Pass the value from the `Link`
+        response header (`rel="next"`) to fetch the next page.
+      schema:
+        type: string
   schemas:
     MarketplaceEntry:
       type: object

package/dist/notification.yml

@@ -203,6 +203,22 @@ paths:
           $ref: '#/components/responses/400-bad-request'
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '403':
+          description: |-
+            A `subscribedByUserEmail` value matches no user in the account, so the whole
+            request is rejected with `invalid_access`, including items that name valid
+            users. The message mentions monitor access even when the caller has full access.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                unknownEmail:
+                  summary: subscribedByUserEmail matches no account user
+                  value:
+                    errors:
+                      - code: invalid_access
+                        message: You can not subscribe notifications for others with monitor access. Please provide your email address while subscribing.
 components:
   securitySchemes:
     bearerAuth:
@@ -463,7 +479,8 @@ components:
             format: email
             description: |-
               Email of the user whose subscription is being modified. Must match a
-              user in the account — unknown emails are silently ignored (no-op).
+              user in the account: one unknown email fails the entire request with
+              **403** `invalid_access`, not just its own item.
             examples:
               - jane@example.com
         required:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.98",
+  "version": "0.2.99",
   "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": "4fcf1e98",
+		"iasCommit": "6feafe65",
 		"generatedAt": "2026-10-12"
 	},
 	"roots": {