@celigo/api-specs 0.2.1

package/dist/script.yml

@@ -0,0 +1,1128 @@
+openapi: 3.2.0
+info:
+  version: 1.0.0
+  title: Scripts
+  description: Manage custom JavaScript scripts used as hooks and transformations in integrations.
+  x-celigo-ai-guidance:
+    - |-
+      API for managing scripts in Celigo.
+      Scripts allow users to write custom JavaScript code to extend the functionality of integrations.
+      They can be used as hooks, transformations,
+      or standalone functions within flows and other resources.
+    - |-
+      Scripts support the integrator-api module for accessing Celigo resources
+      programmatically and run in a secure isolated execution environment.
+servers:
+  - url: https://api.integrator.io
+    description: Production (US / default region)
+  - url: https://api.eu.integrator.io
+    description: Production (EU region)
+  - url: https://api.au.integrator.io
+    description: Production (AU region)
+  - url: https://api.ca.integrator.io
+    description: Production (CA region)
+security:
+  - bearerAuth: []
+tags:
+  - name: Scripts
+    description: |-
+      Scripts are reusable JavaScript functions that extend integration behavior. Use them as hooks in flows, logic in APIs and tools, or prompts in AI agents.
+
+      ## Script schema
+
+      {% openapi-schemas spec="script" schemas="Script" grouped="true" %}
+paths:
+  /v1/scripts:
+    get:
+      x-internal: false
+      summary: List scripts
+      description: Returns all scripts in the account. Response omits `content` to reduce payload size.
+      x-celigo-ai-guidance:
+        - Retrieves a list of all scripts in the system.
+      tags:
+        - Scripts
+      operationId: listScripts
+      parameters:
+        - name: limit
+          in: query
+          required: false
+          description: Maximum number of scripts to return per page.
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 1000
+            default: 1000
+            examples:
+              - 100
+        - $ref: '#/components/parameters/Include'
+        - $ref: '#/components/parameters/Exclude'
+      responses:
+        '200':
+          description: Array of script objects.
+          x-celigo-ai-guidance:
+            - Successfully retrieved list of scripts
+          headers:
+            Link:
+              description: |-
+                RFC 5988 pagination links. Includes `<...>; rel="next"` when more
+                pages remain; absent on the final page.
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Script'
+              examples:
+                default:
+                  value:
+                    - _id: 6356f24327114d57ab843e1f
+                      name: Add Discounts
+                      sandbox: false
+                      postResponseHookToProcessOnChildRecord: false
+                      createdAt: '2022-10-24T20:14:59.070Z'
+                      lastModified: '2026-04-18T13:52:49.729Z'
+                    - _id: 683e20e605d370cc2ec1798c
+                      name: Order Transform
+                      description: Transforms order data before import
+                      sandbox: false
+                      postResponseHookToProcessOnChildRecord: false
+                      _sourceId: 6356f24327114d57ab843e1f
+                      createdAt: '2025-06-02T22:08:38.739Z'
+                      lastModified: '2025-06-02T22:08:38.819Z'
+        '204':
+          description: No scripts exist in the account.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+    post:
+      x-internal: false
+      summary: Create a script
+      description: Creates a new script.
+      x-celigo-ai-guidance:
+        - Creates a new script in the system.
+      tags:
+        - Scripts
+      operationId: createScript
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              minimal:
+                summary: Minimal script
+                value:
+                  name: My Hook
+                  content: |-
+                    function preSavePage(options) {
+                      return { data: options.data, errors: options.errors };
+                    }
+              withDescription:
+                summary: Script with description
+                value:
+                  name: Order Transform
+                  description: Adds discount line items to each order
+                  content: |-
+                    function preSavePage(options) {
+                      for (let d of options.data) {
+                        d.discount = 0;
+                      }
+                      return { data: options.data, errors: options.errors };
+                    }
+        description: Script object to create
+      responses:
+        '201':
+          description: Created script.
+          x-celigo-ai-guidance:
+            - Script created successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Script'
+              examples:
+                created:
+                  summary: Created script
+                  value:
+                    _id: 683e20e605d370cc2ec1798c
+                    name: Order Transform
+                    sandbox: false
+                    postResponseHookToProcessOnChildRecord: false
+                    createdAt: '2025-06-02T22:08:38.739Z'
+                    lastModified: '2025-06-02T22:08:38.819Z'
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '422':
+          $ref: '#/components/responses/422-unprocessable-entity'
+  /v1/scripts/{_id}:
+    get:
+      x-internal: false
+      summary: Get a script
+      description: Returns a single script by ID, including the full `content` field.
+      tags:
+        - Scripts
+      operationId: getScriptById
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      responses:
+        '200':
+          description: Script object.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Script'
+              examples:
+                default:
+                  value:
+                    _id: 6356f24327114d57ab843e1f
+                    name: Add Discounts
+                    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-18T13:52:49.729Z'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+    put:
+      x-internal: false
+      summary: Update a script
+      description: Replaces a script's mutable fields.
+      tags:
+        - Scripts
+      operationId: updateScript
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              default:
+                value:
+                  name: Add Discounts v2
+                  content: |-
+                    function preSavePage(options) {
+                      return { data: options.data, errors: options.errors };
+                    }
+      responses:
+        '200':
+          description: Updated script.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Script'
+              examples:
+                default:
+                  summary: Renamed script
+                  value:
+                    _id: 6356f24327114d57ab843e1f
+                    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':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+    patch:
+      x-internal: false
+      summary: Patch a script
+      description: |-
+        Partially updates a script using JSON Patch (RFC 6902). Only
+        `/debugUntil` is a supported path — all others are rejected with 422.
+        Supported operations: `replace`, `add`, `remove`. The value must be an
+        ISO-8601 timestamp no more than 1 hour in the future.
+      operationId: patchScript
+      tags:
+        - Scripts
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: array
+              minItems: 1
+              items:
+                type: object
+                required:
+                  - op
+                  - path
+                properties:
+                  op:
+                    type: string
+                    enum:
+                      - replace
+                      - add
+                      - remove
+                    x-enumDescriptions:
+                      replace: Replaces the value at the specified path.
+                      add: Sets the value at the specified path.
+                      remove: Removes the value at the specified path.
+                    description: The operation to perform.
+                  path:
+                    type: string
+                    enum:
+                      - /debugUntil
+                    x-enumDescriptions:
+                      /debugUntil: Debug logging expiry timestamp (ISO-8601, max 1 hour from now).
+                    description: JSON Pointer to the field to patch.
+                  value:
+                    type: string
+                    format: date-time
+                    description: ISO-8601 timestamp. Required for `replace` and `add`, omit for `remove`.
+                    examples:
+                      - '2026-05-02T16:00:00.000Z'
+            examples:
+              enable_debug:
+                summary: Enable debug logging for 30 minutes
+                value:
+                  - op: replace
+                    path: /debugUntil
+                    value: '2026-05-02T16:00:00.000Z'
+              disable_debug:
+                summary: Disable debug logging
+                value:
+                  - op: remove
+                    path: /debugUntil
+      responses:
+        '204':
+          description: Script patched.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+        '422':
+          $ref: '#/components/responses/422-unprocessable-entity'
+    delete:
+      x-internal: false
+      summary: Delete a script
+      description: Deletes a script. Soft-deleted and retained in the recycle bin for 30 days.
+      tags:
+        - Scripts
+      operationId: deleteScript
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      responses:
+        '204':
+          description: Script deleted.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+        '422':
+          $ref: '#/components/responses/422-dependency-conflict'
+  /v1/scripts/{_id}/logs:
+    get:
+      x-internal: false
+      summary: Get debug logs for a script
+      description: |-
+        Returns console output captured while debug is enabled on the script
+        (`debugUntil` set to a future timestamp).
+      tags:
+        - Scripts
+      operationId: getScriptLogs
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      responses:
+        '200':
+          description: Log entries for the script.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  logs:
+                    type: array
+                    description: Debug log entries. Empty array when no logs exist or debug is not enabled.
+                    items:
+                      type: object
+                      properties:
+                        time:
+                          type: string
+                          description: Timestamp when the log was captured.
+                          examples:
+                            - '2026-05-22 01:24:38.697'
+                        functionType:
+                          type: string
+                          description: Hook type that produced the log.
+                          examples:
+                            - preSavePage
+                        _resourceId:
+                          type: string
+                          format: objectId
+                          description: ID of the export or import the script was running on.
+                          examples:
+                            - 6843b67b35b64c0bcba2fd69
+                        logLevel:
+                          type: string
+                          description: Severity level of the log entry.
+                          enum:
+                            - INFO
+                            - WARN
+                            - ERROR
+                          x-enumDescriptions:
+                            INFO: Output from `console.log()`.
+                            WARN: Output from `console.warn()`.
+                            ERROR: Output from `console.error()`.
+                        message:
+                          type: string
+                          description: Log message content.
+                          examples:
+                            - test log message from preSavePage
+              examples:
+                withLogs:
+                  summary: Script with debug logs
+                  value:
+                    logs:
+                      - time: '2026-05-22 01:24:38.697'
+                        functionType: preSavePage
+                        _resourceId: 6843b67b35b64c0bcba2fd69
+                        logLevel: WARN
+                        message: test warning from preSavePage
+                      - time: '2026-05-22 01:24:38.697'
+                        functionType: preSavePage
+                        _resourceId: 6843b67b35b64c0bcba2fd69
+                        logLevel: INFO
+                        message: test log message from preSavePage
+                empty:
+                  summary: No logs
+                  value:
+                    logs: []
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+    delete:
+      x-internal: false
+      operationId: deleteScriptLogs
+      tags:
+        - Scripts
+      summary: Delete debug logs for a script
+      description: |-
+        Deletes all debug logs for the specified script. Synchronous and
+        idempotent — works even if the script has no logs.
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      responses:
+        '204':
+          description: Logs deleted.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+  /v1/scripts/{_id}/audit:
+    get:
+      x-internal: false
+      summary: Get audit log for a script
+      description: |-
+        Returns the change history for a script. Each entry records a mutation
+        event with who made the change, when, and which fields were affected.
+      tags:
+        - Scripts
+      operationId: getScriptAudit
+      parameters:
+        - name: _id
+          in: path
+          description: Script ID.
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+            examples:
+              - 6356f24327114d57ab843e1f
+        - name: limit
+          in: query
+          description: Maximum number of audit entries to return per page.
+          required: false
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 1000
+            default: 1000
+            examples:
+              - 100
+        - name: after
+          in: query
+          required: false
+          description: |-
+            Opaque pagination cursor for the next page. Take it from the `after` value in the `Link`
+            response header's `rel="next"` URL rather than constructing it.
+          schema:
+            type: string
+            examples:
+              - W3siJGRhdGUiOiIyMDI2LTA1LTAxVDAwOjAwOjAwLjAwMFoifSwiNjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwIl0
+        - name: from
+          in: query
+          required: false
+          description: Only return entries at or after this timestamp.
+          schema:
+            type: string
+            format: date-time
+            examples:
+              - '2026-05-01T00:00:00.000Z'
+        - name: to
+          in: query
+          required: false
+          description: Only return entries at or before this timestamp.
+          schema:
+            type: string
+            format: date-time
+            examples:
+              - '2026-05-31T23:59:59.999Z'
+        - name: action
+          in: query
+          required: false
+          description: Filter by the change type. Maps to the `event` field on each entry.
+          schema:
+            type: string
+            enum:
+              - create
+              - update
+              - delete
+              - view
+              - restore
+              - purge
+              - signin
+              - signout
+              - purgelogs
+            examples:
+              - update
+            x-enumDescriptions:
+              create: A resource was created.
+              update: A resource was modified.
+              delete: A resource was deleted (moved to recycle bin).
+              view: A resource was viewed or accessed.
+              restore: A resource was restored from the recycle bin.
+              purge: A resource was permanently purged from the recycle bin.
+              signin: A user signed in to the account.
+              signout: A user signed out of the account.
+              purgelogs: Execution logs were purged for a resource.
+        - name: source
+          in: query
+          required: false
+          description: Filter by how the change was initiated.
+          schema:
+            type: string
+            enum:
+              - ui
+              - api
+              - system
+              - connector
+              - script
+              - sso
+            examples:
+              - ui
+            x-enumDescriptions:
+              ui: Change made through the Celigo web UI.
+              api: Change made via the REST API.
+              system: Change made automatically by the platform.
+              connector: Change made by an Integration App (connector) process.
+              script: Change made by a custom script execution.
+              sso: Change triggered by an SSO authentication event.
+        - name: _byUserId
+          in: query
+          required: false
+          description: Filter to changes performed by a single user.
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: users
+            examples:
+              - 624cb0346309dc3a543733a2
+      responses:
+        '200':
+          description: Array of audit entries, newest first.
+          headers:
+            Link:
+              description: |-
+                RFC 5988 pagination link. Includes `<...>; rel="next"` with an
+                `after` cursor when more entries exist; absent on the final page.
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    _id:
+                      type: string
+                      format: objectId
+                      description: Unique identifier for this audit entry.
+                      examples:
+                        - 69e38cb1a749d34a9732a270
+                    resourceType:
+                      type: string
+                      description: Always `script` for this endpoint.
+                    _resourceId:
+                      type: string
+                      format: objectId
+                      x-celigo-refModel: scripts
+                      description: ID of the script this entry belongs to.
+                      examples:
+                        - 6356f24327114d57ab843e1f
+                    event:
+                      type: string
+                      description: Type of change that occurred.
+                      enum:
+                        - create
+                        - update
+                        - delete
+                        - purge
+                        - restore
+                      x-enumDescriptions:
+                        create: Script was created.
+                        update: Script was modified.
+                        delete: Script was soft-deleted (moved to recycle bin).
+                        purge: Script was permanently purged from the recycle bin.
+                        restore: Script was restored from the recycle bin.
+                    source:
+                      type: string
+                      description: How the change was initiated.
+                      enum:
+                        - api
+                        - ui
+                        - system
+                      x-enumDescriptions:
+                        api: Change made via the REST API.
+                        ui: Change made through the Celigo UI.
+                        system: Change made by an automated platform process.
+                    time:
+                      type: string
+                      format: date-time
+                      description: When the change occurred.
+                      examples:
+                        - '2026-04-18T13:52:49.729Z'
+                    byUser:
+                      type: object
+                      description: User who made the change.
+                      properties:
+                        _id:
+                          type: string
+                          format: objectId
+                          x-celigo-refModel: users
+                          description: User ID.
+                          examples:
+                            - 624cb0346309dc3a543733a2
+                        email:
+                          type: string
+                          format: email
+                          description: User email address.
+                          examples:
+                            - user@example.com
+                        name:
+                          type: string
+                          description: User display name.
+                          examples:
+                            - Tyler Lamparter
+                    fieldChanges:
+                      type: array
+                      description: Fields that were modified.
+                      items:
+                        type: object
+                        properties:
+                          fieldPath:
+                            type: string
+                            description: Dot-notation path of the changed field.
+                            examples:
+                              - debugUntil
+                          oldValue:
+                            description: Previous value (absent on create).
+                          newValue:
+                            description: New value (absent on delete).
+                    deletedInfo:
+                      type: object
+                      description: Metadata about the deleted resource. Present on `delete` events.
+                      properties:
+                        name:
+                          type: string
+                          description: Name of the resource at the time of deletion.
+                          examples:
+                            - Add Discounts
+              examples:
+                default:
+                  value:
+                    - _id: 69e38cb1a749d34a9732a270
+                      resourceType: script
+                      _resourceId: 6356f24327114d57ab843e1f
+                      source: api
+                      event: update
+                      time: '2026-04-18T13:52:49.729Z'
+                      byUser:
+                        _id: 624cb0346309dc3a543733a2
+                        email: user@example.com
+                        name: Tyler Lamparter
+                      fieldChanges:
+                        - fieldPath: debugUntil
+                          oldValue: '2026-04-18T14:52:43.041Z'
+        '204':
+          description: No audit entries exist for this script.
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+        '422':
+          $ref: '#/components/responses/422-unprocessable-entity'
+  /v1/scripts/{_id}/dependencies:
+    get:
+      x-internal: false
+      operationId: listScriptDependencies
+      tags:
+        - Scripts
+      summary: List dependencies of a script
+      description: Returns the set of resources that depend on the specified script.
+      parameters:
+        - name: _id
+          in: path
+          required: true
+          description: Script ID.
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: scripts
+      responses:
+        '200':
+          description: |
+            Dependency map. Keys are resource-type strings; values are arrays
+            of dependency entries. Returns `{}` when no dependents exist.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DependencyResponse'
+              examples:
+                none:
+                  summary: No dependents (also returned for a nonexistent ID)
+                  value: {}
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+components:
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+  parameters:
+    Include:
+      name: include
+      in: query
+      required: false
+      description: |-
+        Comma-separated list of fields to project into each returned record.
+        Triggers summary projection: the response contains a minimal identity
+        set (`_id`, `name`, plus resource-specific fields) with the requested
+        fields added on top. Supports dot notation for nested fields.
+        Mutually exclusive with `exclude`.
+      schema:
+        type: string
+      example: _integrationId,disabled,lastModified
+    Exclude:
+      name: exclude
+      in: query
+      required: false
+      description: |-
+        Comma-separated list of fields to strip from the default response.
+        Unlike `include`, does not trigger summary projection — returns the
+        full record with the named fields removed. Protected identity fields
+        (e.g. `name`) cannot be stripped. Mutually exclusive with `include`.
+      schema:
+        type: string
+      example: createdAt,lastModified
+  schemas:
+    Script:
+      type: object
+      description: Script resource as returned by the API.
+      required:
+        - _id
+        - name
+        - createdAt
+        - lastModified
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          description: Unique identifier for the script.
+          examples:
+            - 6356f24327114d57ab843e1f
+        name:
+          type: string
+          maxLength: 100
+          description: Display name for the script.
+          examples:
+            - Order Transform Hook
+        description:
+          type: string
+          maxLength: 1024
+          description: Free-text explanation of what the script does.
+          examples:
+            - Adds discount line items to each order before import
+        content:
+          type: string
+          description: |-
+            JavaScript source code. Only returned on GET-by-ID, omitted from
+            list responses to reduce payload size.
+          examples:
+            - |-
+              function preSavePage(options) {
+                return { data: options.data, errors: options.errors };
+              }
+        postResponseHookToProcessOnChildRecord:
+          type: boolean
+          default: false
+          description: When true, postResponseMap hooks run once per child record in a one-to-many mapping instead of once per parent.
+        debugUntil:
+          type: string
+          format: date-time
+          readOnly: true
+          description: |-
+            Debug logging is active until this timestamp. Absent or in the past
+            means debug is off. Can only be set via PATCH — ignored on POST and PUT.
+            Maximum 1 hour from the current time.
+          examples:
+            - '2026-05-22T03:30:00.000Z'
+        _sourceId:
+          type: string
+          format: objectId
+          readOnly: true
+          x-celigo-refModel: scripts
+          description: Source script this was cloned from. Present only on scripts created by cloning.
+          examples:
+            - 6356f24327114d57ab843e1f
+        _templateId:
+          type: string
+          format: objectId
+          readOnly: true
+          x-celigo-refModel: templates
+          description: The template (`templates` resource) this script was generated from. Present only on scripts created from a template; omitted otherwise.
+          examples:
+            - 64a1b2c3d4e5f6a7b8c9d0e1
+        createdAt:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the script was created.
+          examples:
+            - '2022-10-24T20:14:59.070Z'
+        lastModified:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the script was last updated.
+          examples:
+            - '2026-04-18T13:52:49.729Z'
+    Request:
+      type: object
+      description: Fields for creating or updating a script.
+      x-celigo-ai-guidance:
+        - Fields that can be sent when creating or updating a script
+      required:
+        - name
+      properties:
+        name:
+          type: string
+          minLength: 1
+          maxLength: 100
+          description: Display name for the script.
+          examples:
+            - Order Transform Hook
+        description:
+          type: string
+          maxLength: 1024
+          description: Free-text explanation of what the script does.
+          examples:
+            - Adds discount line items to each order before import
+        content:
+          type: string
+          description: |-
+            JavaScript source code. Optional on create — the server initializes
+            omitted content to an empty string. Omitting it on update leaves the
+            stored source unchanged (it is not cleared).
+          x-celigo-ai-guidance:
+            - JavaScript source code content of the script.
+            - Optional. Omitted on create = empty script; omitted on update = existing content preserved.
+          examples:
+            - |-
+              function preSavePage(options) {
+                return { data: options.data, errors: options.errors };
+              }
+        postResponseHookToProcessOnChildRecord:
+          type: boolean
+          default: false
+          description: When true, postResponseMap hooks run once per child record in a one-to-many mapping instead of once per parent.
+          x-celigo-ai-guidance:
+            - Whether to process hooks on child records.
+        _templateId:
+          type: string
+          format: objectId
+          x-celigo-refModel: templates
+          description: Optional template identifier used to generate or structure script content.
+    Error:
+      type: object
+      description: Standard error response envelope returned by integrator.io APIs.
+      properties:
+        errors:
+          type: array
+          description: List of errors that occurred while processing the request.
+          items:
+            type: object
+            properties:
+              code:
+                oneOf:
+                  - type: string
+                  - type: integer
+                description: |-
+                  Machine-readable error code. Usually a string like
+                  `invalid_ref`, `missing_required_field`, or `unauthorized`;
+                  may be an **integer** when the error mirrors an upstream HTTP
+                  status (e.g. `500`) — most commonly returned by connection-ping
+                  and adaptor-proxy responses.
+              message:
+                type: string
+                description: Human-readable description of the error.
+              field:
+                type: string
+                description: |-
+                  Optional pointer to the document field that caused the error.
+                  Used by structural validation errors (`missing_required_field`,
+                  `invalid_ref`) to indicate which field is at fault
+                  (e.g. `_id`, `type`, `http.baseURI`).
+              source:
+                type: string
+                description: |-
+                  Optional origin layer for the error — e.g. `application` when
+                  the error came from the remote system the adaptor called,
+                  `connector` when the adaptor itself rejected the request.
+            required:
+              - message
+      required:
+        - errors
+    DependencyEntry:
+      type: object
+      description: A single resource that depends on the queried resource.
+      properties:
+        id:
+          type: string
+          description: Unique identifier of the dependent resource.
+          examples:
+            - 61f92026dd053843b5d72350
+        name:
+          type: string
+          description: Display name of the dependent resource.
+          examples:
+            - Import Orders to NetSuite
+        paths:
+          type: array
+          description: |-
+            Dot-notation paths within the dependent resource that reference
+            the target resource. `[*]` denotes array elements.
+          items:
+            type: string
+          examples:
+            - - hooks.preSavePage._scriptId
+        accessLevel:
+          type: string
+          description: The caller's access level on the dependent resource.
+          examples:
+            - manage
+        dependencyIds:
+          type: object
+          description: |-
+            Map of resource types to arrays of IDs that this dependent
+            resource references on the target. Keys are singular or plural
+            resource type strings; values are arrays of ID strings.
+          additionalProperties:
+            type: array
+            items:
+              type: string
+          example:
+            script:
+              - 64ff4b21612a134bd2f45531
+      required:
+        - id
+        - name
+        - paths
+        - accessLevel
+        - dependencyIds
+    DependencyResponse:
+      type: object
+      description: |
+        Map of dependent-resource types to arrays of dependency entries.
+        Keys are plural resource type strings (e.g. `flows`, `imports`,
+        `connections`). An empty object `{}` means no dependents.
+      additionalProperties:
+        type: array
+        items:
+          $ref: '#/components/schemas/DependencyEntry'
+      example:
+        exports:
+          - id: 64ff4b21612a134bd2f45534
+            name: Bank FTP Export
+            paths:
+              - hooks.preSavePage._scriptId
+            accessLevel: manage
+            dependencyIds:
+              script:
+                - 64ff4b21612a134bd2f45531
+        flows:
+          - id: 64ff4b22612a134bd2f45538
+            name: CAMT-053 to Celigo CAM Format
+            paths:
+              - pageGenerators[*]._exportId
+            accessLevel: manage
+            dependencyIds:
+              export:
+                - 64ff4b21612a134bd2f45534
+  responses:
+    401-unauthorized:
+      description: |-
+        Unauthorized. The request lacks a valid bearer token, or the provided token
+        failed to authenticate.
+
+        Note: the 401 response is produced by the auth middleware **before** the
+        request reaches the endpoint handler, so it does **not** follow the
+        standard `{errors: [...]}` envelope. Instead the body is a bare
+        `{message: string}` object with no `code`, no `errors` array. Callers
+        handling 401s should key off the HTTP status and the `message` string,
+        not try to destructure an `errors[]`.
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              message:
+                type: string
+                description: |-
+                  Human-readable description of the auth failure. Known values:
+                  - `"Unauthorized"` — no `Authorization` header on the request.
+                  - `"Bearer Authentication Failed"` — header present but token
+                    is invalid, revoked, or expired.
+            required:
+              - message
+          examples:
+            missing_token:
+              summary: No Authorization header sent
+              value:
+                message: Unauthorized
+            invalid_token:
+              summary: Bearer token invalid or revoked
+              value:
+                message: Bearer Authentication Failed
+    400-bad-request:
+      description: |
+        Bad request. The server could not understand the request because of malformed syntax or invalid parameters.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          examples:
+            default:
+              value:
+                errors:
+                  - code: invalid_request
+                    message: The request body failed validation.
+    422-unprocessable-entity:
+      description: |
+        Unprocessable entity. The request was well-formed but was unable to be followed due to semantic errors.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          examples:
+            default:
+              value:
+                errors:
+                  - code: unprocessable_entity
+                    message: The request could not be processed due to a semantic error.
+    404-not-found:
+      description: |
+        Not found. The requested resource does not exist or is not visible to the caller.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          examples:
+            default:
+              value:
+                errors:
+                  - code: not_found
+                    message: The requested resource was not found.
+    422-dependency-conflict:
+      description: |-
+        The resource has dependents that must be deleted first. Each entry
+        in the `errors` array names one blocking resource.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          examples:
+            default:
+              value:
+                errors:
+                  - code: dependencies_not_deleted
+                    message: export 6902d88c10b42b2eaac9b2a1 must be deleted before you can delete connection 6398ddf316be761fb16a6523
+x-enable-proxy: true
+x-internal: false