@celigo/api-specs 0.2.165 → 0.2.167

package/dist/environment.yml

@@ -41,6 +41,14 @@ paths:
         `feature_not_enabled`. Every account with the feature has at least
         one environment (Production). The full list is returned in a single
         unpaginated response.
+
+        Listing works from production for the account owner and administrators.
+        Outside production, only an API token created in that environment can
+        list (it acts as the environment's own user); a workspace user working
+        in a non-production environment, signed in or with a personal access
+        token, gets 403 `access_restricted`. Every other environment operation
+        is production-only and answers that 403 to any caller outside
+        production.
       responses:
         '200':
           description: List of environments.
@@ -70,8 +78,39 @@ paths:
                       createdAt: '2025-11-12T22:28:22.433Z'
         '204':
           description: No environments exist in the account
+        '400':
+          description: The account doesn't have the environments feature.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              example:
+                errors:
+                  - code: feature_not_enabled
+                    message: The environment feature is not enabled for the account.
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '403':
+          description: |-
+            A manage or monitor user in production, or a workspace user (signed in, or with a
+            personal access token) working in a non-production environment.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                nonProductionEnvironment:
+                  summary: A workspace user working in a non-production environment
+                  value:
+                    errors:
+                      - code: access_restricted
+                        message: This request can only be made through the production environment.
+                notAdministrator:
+                  summary: A manage or monitor user
+                  value:
+                    errors:
+                      - code: access_restricted
+                        message: You don't have the right to perform this action. Please contact your account administrator to receive manage permission for this account.
     post:
       x-internal: false
       summary: Create an environment
@@ -122,6 +161,8 @@ paths:
           $ref: '#/components/responses/400-bad-request'
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-production-only'
         '422':
           $ref: '#/components/responses/422-unprocessable-entity'
   /v1/environments/{_id}:
@@ -174,6 +215,8 @@ paths:
                     createdAt: '2025-11-12T22:28:22.433Z'
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-production-only'
         '404':
           $ref: '#/components/responses/404-not-found'
     put:
@@ -237,6 +280,8 @@ paths:
           $ref: '#/components/responses/400-bad-request'
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-production-only'
         '404':
           $ref: '#/components/responses/404-not-found'
         '422':
@@ -256,6 +301,12 @@ paths:
 
         Requires a `Content-Type: application/json` header even though no
         request body is needed.
+      x-celigo-ai-guidance:
+        - |-
+          The call flips whatever state it finds. Read the environment's `enabled` with
+          GET /v1/environments/{_id} first and call only when it differs from the state you want;
+          after a timeout or a 5xx, read it again before retrying, because a resent request undoes
+          the first.
       parameters:
         - name: _id
           in: path
@@ -280,6 +331,8 @@ paths:
                     message: Production environment cannot be disabled.
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-production-only'
         '404':
           $ref: '#/components/responses/404-not-found'
         '422':
@@ -291,7 +344,7 @@ paths:
               example:
                 errors:
                   - code: resolve_pending_invitation
-                    message: Please resolve pending invitations before disabling this environment.
+                    message: Please resolve any pending user invitations to disable the environment.
 components:
   securitySchemes:
     bearerAuth:
@@ -449,15 +502,6 @@ components:
               type: boolean
               readOnly: true
               description: When true, the environment has been migrated from legacy sandbox. Present only on enterprise accounts.
-    Request:
-      type: object
-      description: Fields for creating or updating an environment.
-      x-celigo-ai-guidance:
-        - Fields that can be sent when creating or updating a environment
-      required:
-        - name
-      allOf:
-        - $ref: '#/components/schemas/EnvironmentBase'
     Error:
       type: object
       description: Standard error response envelope returned by integrator.io APIs.
@@ -498,6 +542,15 @@ components:
               - message
       required:
         - errors
+    Request:
+      type: object
+      description: Fields for creating or updating an environment.
+      x-celigo-ai-guidance:
+        - Fields that can be sent when creating or updating a environment
+      required:
+        - name
+      allOf:
+        - $ref: '#/components/schemas/EnvironmentBase'
   responses:
     401-unauthorized:
       description: |-
@@ -546,6 +599,20 @@ components:
                 errors:
                   - code: invalid_request
                     message: The request body failed validation.
+    403-production-only:
+      description: |-
+        The request was made from a non-production environment -- with a token created there, or
+        by a workspace user working there. Environments are managed from production only.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          examples:
+            nonProductionEnvironment:
+              value:
+                errors:
+                  - code: access_restricted
+                    message: This request can only be made through the production environment.
     422-unprocessable-entity:
       description: |
         Unprocessable entity. The request was well-formed but was unable to be followed due to semantic errors.

package/dist/export.yml

@@ -16984,7 +16984,7 @@ components:
             asynchronous:
               type: boolean
               readOnly: true
-              description: Server-managed execution-mode flag set on creation; client values are ignored.
+              description: Server-managed execution-mode flag set on creation.
             __linkedLookupCacheIds:
               type: array
               readOnly: true

package/dist/integration.yml

@@ -5167,7 +5167,8 @@ components:
           maxLength: 1024
           description: |-
             Caller-chosen key set at creation or update. Present only when it was supplied; filter the
-            list with `GET /v1/topics?externalId=…`.
+            list with `GET /v1/topics?externalId=…`. Not unique: the filtered list can hold more than
+            one topic, so use `_id` to address a topic.
           examples:
             - erp-orders-created
         _integrationId:
@@ -5304,6 +5305,7 @@ components:
           description: |-
             Caller-chosen key for finding the topic again without storing its id — filter the list with
             `GET /v1/topics?externalId=…`. Integration Apps use it to locate a topic across installs.
+            Not unique: another topic can carry the same value, so the filtered list can hold several.
           examples:
             - erp-orders-created
         draft:

package/dist/job.yml

@@ -71,13 +71,8 @@ paths:
         forward, take the `createdAt` of the last record, subtract 1 ms, and
         pass it as `createdAt_lte`.
 
-        In a live probe (2026-10-21) the date filters applied to a `running`
-        flow job too: created outside `createdAt_gte` / `createdAt_lte`, it was
-        left out of every date-filtered list, whether the query was scoped by
-        flow and integration, by integration, or not at all. `queued` and
-        `canceling` jobs were not tested; if `queued` jobs are pinned to the
-        first page, that page can hold rows the date filters would otherwise
-        exclude, so tolerate out-of-range rows when paging.
+        A `queued` or `running` job created outside `createdAt_gte` /
+        `createdAt_lte` is left out of a date-filtered list.
       parameters:
         - name: _integrationId
           in: query
@@ -356,6 +351,19 @@ paths:
                         message: The query parameter "status" has invalid value.
         '401':
           $ref: '#/components/responses/401-unauthorized'
+        '422':
+          description: A query parameter the listing does not support; the message names it.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                unsupported_param:
+                  summary: Unsupported query parameter
+                  value:
+                    errors:
+                      - code: invalid_query_params
+                        message: 'The following query parameter(s) are not supported: limit.'
   /v1/jobs/current:
     post:
       x-internal: false

package/dist/mcp-server.yml

@@ -4439,8 +4439,8 @@ components:
           type: integer
           description: |-
             Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
-            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
-            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            REST and RESTlet calls. Send no more than the integrator.io license ceiling (25 standard,
+            50 with an Environments license). NetSuite separately enforces one
             concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
             APIs shares — all integrator.io connections to that account and every other client
             calling those APIs from outside integrator.io (other integrations, third-party tools).
@@ -4623,9 +4623,8 @@ components:
           type: integer
           description: |-
             Maximum number of concurrent API requests to Salesforce. Salesforce enforces per-org API
-            request limits, so setting this high consumes the org's API call allocation faster. Values
-            above the licensed ceiling are silently clamped (live-verified: a request for 999 is stored
-            as 50).
+            request limits, so setting this high consumes the org's API call allocation faster. Send no
+            more than the account's licensed ceiling.
           minimum: 1
           maximum: 50
           default: 5
@@ -4634,7 +4633,7 @@ components:
           description: |-
             Upper bound for auto-scaling concurrency. When automatic rate-limit recovery is enabled, the
             system adjusts concurrency between 1 and this value based on rate-limit feedback from
-            Salesforce. Values above the licensed ceiling are silently clamped to 50.
+            Salesforce. Send no more than the account's licensed ceiling.
           minimum: 1
           maximum: 50
           default: 5
@@ -4803,7 +4802,7 @@ components:
           description: |
             Maximum number of concurrent file transfer operations.
             FTP servers often have low connection limits — keep this value conservative.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
             Unlike the rest of the `ftp` object, a `PUT` that omits this field keeps the stored value instead of clearing it.
           minimum: 1
           maximum: 50
@@ -4826,8 +4825,8 @@ components:
           minimum: 1
           description: |-
             Number of parallel transfer threads for this FTP connection. Must be a
-            whole number — decimals are rejected on save. Values above the
-            account's licensed concurrency maximum are silently clamped down. On
+            whole number — decimals are rejected on save. Send no more than the
+            account's licensed concurrency maximum. On
             save the value is mirrored into `userConcurrencyLevel` (and into
             `userTargetConcurrencyLevel` when auto-recovery of rate-limit errors
             is active with `targetConcurrencyLevel` set); clearing it clears the
@@ -4939,8 +4938,8 @@ components:
           description: |-
             Maximum number of concurrent S3 operations. Applies when `autoRecoverRateLimitErrors` is
             false; when auto-recover is on (the default) concurrency auto-scales up to
-            `targetConcurrencyLevel` and a `concurrencyLevel` sent on its own is reconciled back. Values
-            above the account's licensed maximum are clamped down.
+            `targetConcurrencyLevel` and a `concurrencyLevel` sent on its own is reconciled back. Send no
+            more than the account's licensed maximum.
           minimum: 1
           maximum: 50
           default: 5
@@ -5545,8 +5544,8 @@ components:
 
             Higher values increase throughput but may trigger API rate limits.
             Set this based on the target API's rate limit documentation.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down,
-            but a decimal is rejected with 422 `invalid_field_value` on every write (the same rule applies to every
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
+            A decimal is rejected with 422 `invalid_field_value` on every write (the same rule applies to every
             adaptor's `concurrencyLevel` and `targetConcurrencyLevel`, and to `ftp.multiThreadCount`).
             Platform-managed while `autoRecoverRateLimitErrors` is true — a PUT ignores the value and the recovery machinery moves it toward the target; set `targetConcurrencyLevel` instead.
             At level 1 an import's pages run one at a time, so a record's existence lookup and write finish before the next record's start (measured on a single import); the import's `idLockTemplate` serializes only same-key records and leaves the rest parallel.
@@ -6788,7 +6787,7 @@ components:
           description: |
             Maximum number of concurrent database connections.
             Set based on the database server's connection limit and available resources.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -7409,7 +7408,7 @@ components:
           type: integer
           description: |
             Maximum number of concurrent MongoDB operations.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -7993,8 +7992,8 @@ components:
           type: integer
           description: |-
             Maximum number of messages processed concurrently for this connection. The default of 5
-            is safe for most partners. Values above the account's licensed maximum (25 standard, 50
-            with an Environments license) are silently clamped down.
+            is safe for most partners. Send no more than the account's licensed maximum (25 standard,
+            50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -8046,9 +8045,8 @@ components:
         concurrencyLevel:
           type: integer
           description: |-
-            Maximum number of files processed concurrently. Cannot exceed `targetConcurrencyLevel`; a higher
-            value is silently clamped down to it. Values above the account's licensed maximum (25 standard,
-            50 with an Environments license) are also clamped down.
+            Maximum number of files processed concurrently. Send no more than `targetConcurrencyLevel` and
+            the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 1
@@ -8056,8 +8054,8 @@ components:
           type: integer
           description: |-
             Upper bound for auto-scaling. The agent scales concurrency between 1 and this value based on
-            throughput, so it also caps `concurrencyLevel`. Values above the account's licensed maximum
-            (25 standard, 50 with an Environments license) are silently clamped down.
+            throughput, so it also caps `concurrencyLevel`. Send no more than the account's licensed maximum
+            (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 1
@@ -8512,8 +8510,7 @@ components:
           description: |-
             Maximum number of DynamoDB requests this connection runs at once.
 
-            Values are silently clamped into the licensed range — below 1 is raised to 1, and above the
-            account maximum (25 standard, 50 with an Environments license) is lowered to that maximum.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -8526,7 +8523,7 @@ components:
           description: |-
             Concurrency ceiling for auto-scaling. The system adjusts the active concurrency between 1
             and this value based on rate-limit feedback. Only applied when `autoRecoverRateLimitErrors`
-            is enabled on the connection. Clamped the same way as `concurrencyLevel`.
+            is enabled on the connection. The same licensed maximum applies as for `concurrencyLevel`.
           minimum: 1
           maximum: 50
           default: 5
@@ -8687,7 +8684,7 @@ components:
             Maximum number of concurrent database connections.
             JDBC connections often run through a single Agent, so keep this value
             conservative to avoid overwhelming the Agent or database.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -8993,7 +8990,7 @@ components:
           type: integer
           description: |
             Maximum number of concurrent operations through this wrapper connection.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5

package/dist/script.yml

@@ -243,10 +243,6 @@ paths:
                     name: Add Discounts v2
                     sandbox: false
                     postResponseHookToProcessOnChildRecord: false
-                    content: |-
-                      function preSavePage(options) {
-                        return { data: options.data, errors: options.errors };
-                      }
                     createdAt: '2022-10-24T20:14:59.070Z'
                     lastModified: '2026-04-21T09:05:11.342Z'
         '400':
@@ -904,8 +900,8 @@ components:
         content:
           type: string
           description: |-
-            JavaScript source code. Only returned on GET-by-ID, omitted from
-            list responses to reduce payload size.
+            JavaScript source code. Only returned by a GET of one script; list,
+            create and update responses omit it.
           examples:
             - |-
               function preSavePage(options) {

package/dist/tool.yml

@@ -7947,8 +7947,8 @@ components:
           type: integer
           description: |-
             Maximum number of requests this connection sends to NetSuite in parallel, across SOAP,
-            REST and RESTlet calls. Values above the integrator.io license ceiling (25 standard, 50
-            with an Environments license) are stored as that ceiling. NetSuite separately enforces one
+            REST and RESTlet calls. Send no more than the integrator.io license ceiling (25 standard,
+            50 with an Environments license). NetSuite separately enforces one
             concurrency limit per NetSuite account that every caller of its SOAP, REST and RESTlet
             APIs shares — all integrator.io connections to that account and every other client
             calling those APIs from outside integrator.io (other integrations, third-party tools).
@@ -8131,9 +8131,8 @@ components:
           type: integer
           description: |-
             Maximum number of concurrent API requests to Salesforce. Salesforce enforces per-org API
-            request limits, so setting this high consumes the org's API call allocation faster. Values
-            above the licensed ceiling are silently clamped (live-verified: a request for 999 is stored
-            as 50).
+            request limits, so setting this high consumes the org's API call allocation faster. Send no
+            more than the account's licensed ceiling.
           minimum: 1
           maximum: 50
           default: 5
@@ -8142,7 +8141,7 @@ components:
           description: |-
             Upper bound for auto-scaling concurrency. When automatic rate-limit recovery is enabled, the
             system adjusts concurrency between 1 and this value based on rate-limit feedback from
-            Salesforce. Values above the licensed ceiling are silently clamped to 50.
+            Salesforce. Send no more than the account's licensed ceiling.
           minimum: 1
           maximum: 50
           default: 5
@@ -8311,7 +8310,7 @@ components:
           description: |
             Maximum number of concurrent file transfer operations.
             FTP servers often have low connection limits — keep this value conservative.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
             Unlike the rest of the `ftp` object, a `PUT` that omits this field keeps the stored value instead of clearing it.
           minimum: 1
           maximum: 50
@@ -8334,8 +8333,8 @@ components:
           minimum: 1
           description: |-
             Number of parallel transfer threads for this FTP connection. Must be a
-            whole number — decimals are rejected on save. Values above the
-            account's licensed concurrency maximum are silently clamped down. On
+            whole number — decimals are rejected on save. Send no more than the
+            account's licensed concurrency maximum. On
             save the value is mirrored into `userConcurrencyLevel` (and into
             `userTargetConcurrencyLevel` when auto-recovery of rate-limit errors
             is active with `targetConcurrencyLevel` set); clearing it clears the
@@ -8447,8 +8446,8 @@ components:
           description: |-
             Maximum number of concurrent S3 operations. Applies when `autoRecoverRateLimitErrors` is
             false; when auto-recover is on (the default) concurrency auto-scales up to
-            `targetConcurrencyLevel` and a `concurrencyLevel` sent on its own is reconciled back. Values
-            above the account's licensed maximum are clamped down.
+            `targetConcurrencyLevel` and a `concurrencyLevel` sent on its own is reconciled back. Send no
+            more than the account's licensed maximum.
           minimum: 1
           maximum: 50
           default: 5
@@ -9053,8 +9052,8 @@ components:
 
             Higher values increase throughput but may trigger API rate limits.
             Set this based on the target API's rate limit documentation.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down,
-            but a decimal is rejected with 422 `invalid_field_value` on every write (the same rule applies to every
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
+            A decimal is rejected with 422 `invalid_field_value` on every write (the same rule applies to every
             adaptor's `concurrencyLevel` and `targetConcurrencyLevel`, and to `ftp.multiThreadCount`).
             Platform-managed while `autoRecoverRateLimitErrors` is true — a PUT ignores the value and the recovery machinery moves it toward the target; set `targetConcurrencyLevel` instead.
             At level 1 an import's pages run one at a time, so a record's existence lookup and write finish before the next record's start (measured on a single import); the import's `idLockTemplate` serializes only same-key records and leaves the rest parallel.
@@ -10296,7 +10295,7 @@ components:
           description: |
             Maximum number of concurrent database connections.
             Set based on the database server's connection limit and available resources.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -10917,7 +10916,7 @@ components:
           type: integer
           description: |
             Maximum number of concurrent MongoDB operations.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -11501,8 +11500,8 @@ components:
           type: integer
           description: |-
             Maximum number of messages processed concurrently for this connection. The default of 5
-            is safe for most partners. Values above the account's licensed maximum (25 standard, 50
-            with an Environments license) are silently clamped down.
+            is safe for most partners. Send no more than the account's licensed maximum (25 standard,
+            50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -11554,9 +11553,8 @@ components:
         concurrencyLevel:
           type: integer
           description: |-
-            Maximum number of files processed concurrently. Cannot exceed `targetConcurrencyLevel`; a higher
-            value is silently clamped down to it. Values above the account's licensed maximum (25 standard,
-            50 with an Environments license) are also clamped down.
+            Maximum number of files processed concurrently. Send no more than `targetConcurrencyLevel` and
+            the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 1
@@ -11564,8 +11562,8 @@ components:
           type: integer
           description: |-
             Upper bound for auto-scaling. The agent scales concurrency between 1 and this value based on
-            throughput, so it also caps `concurrencyLevel`. Values above the account's licensed maximum
-            (25 standard, 50 with an Environments license) are silently clamped down.
+            throughput, so it also caps `concurrencyLevel`. Send no more than the account's licensed maximum
+            (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 1
@@ -12020,8 +12018,7 @@ components:
           description: |-
             Maximum number of DynamoDB requests this connection runs at once.
 
-            Values are silently clamped into the licensed range — below 1 is raised to 1, and above the
-            account maximum (25 standard, 50 with an Environments license) is lowered to that maximum.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -12034,7 +12031,7 @@ components:
           description: |-
             Concurrency ceiling for auto-scaling. The system adjusts the active concurrency between 1
             and this value based on rate-limit feedback. Only applied when `autoRecoverRateLimitErrors`
-            is enabled on the connection. Clamped the same way as `concurrencyLevel`.
+            is enabled on the connection. The same licensed maximum applies as for `concurrencyLevel`.
           minimum: 1
           maximum: 50
           default: 5
@@ -12195,7 +12192,7 @@ components:
             Maximum number of concurrent database connections.
             JDBC connections often run through a single Agent, so keep this value
             conservative to avoid overwhelming the Agent or database.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -12501,7 +12498,7 @@ components:
           type: integer
           description: |
             Maximum number of concurrent operations through this wrapper connection.
-            Values above the account's licensed maximum (25 standard, 50 with an Environments license) are silently clamped down.
+            Send no more than the account's licensed maximum (25 standard, 50 with an Environments license).
           minimum: 1
           maximum: 50
           default: 5
@@ -38009,7 +38006,7 @@ components:
             asynchronous:
               type: boolean
               readOnly: true
-              description: Server-managed execution-mode flag set on creation; client values are ignored.
+              description: Server-managed execution-mode flag set on creation.
             __linkedLookupCacheIds:
               type: array
               readOnly: true

package/dist/topic.yml

@@ -1253,7 +1253,8 @@ components:
           maxLength: 1024
           description: |-
             Caller-chosen key set at creation or update. Present only when it was supplied; filter the
-            list with `GET /v1/topics?externalId=…`.
+            list with `GET /v1/topics?externalId=…`. Not unique: the filtered list can hold more than
+            one topic, so use `_id` to address a topic.
           examples:
             - erp-orders-created
         _integrationId:
@@ -1430,6 +1431,7 @@ components:
           description: |-
             Caller-chosen key for finding the topic again without storing its id — filter the list with
             `GET /v1/topics?externalId=…`. Integration Apps use it to locate a topic across installs.
+            Not unique: another topic can carry the same value, so the filtered list can hold several.
           examples:
             - erp-orders-created
         draft:

package/dist/tradingpartnerconnector.yml

@@ -363,14 +363,13 @@ paths:
       x-internal: false
       summary: Update a trading partner connector
       description: |-
-        Replaces a trading partner connector. This is a full replace and an
-        upsert -- if no connector exists for the given ID, one is created.
-        When `published` is set to `true`, the `supportedBy` sections are
-        validated for required fields.
+        Replaces an existing trading partner connector (a full replace). Create
+        connectors with `POST /v1/tpconnectors`. When `published` is set to
+        `true`, the `supportedBy` sections are validated for required fields.
       x-celigo-ai-guidance:
         - |-
           Updates an existing trading partner connector with the provided configuration.
-          This endpoint can also create a connector if no document exists for the given ID.
+          Create connectors with POST /v1/tpconnectors; PUT replaces one that already exists.
         - |-
           When `published` is set to true,
           validation is enforced on the `supportedBy` sections to ensure all required