@celigo/api-specs 0.2.1

package/dist/ediprofile.yml

@@ -0,0 +1,911 @@
+openapi: 3.2.0
+info:
+  version: 1.0.0
+  title: EDI Profiles
+  description: API for managing Celigo EDI profiles — interchange envelope configurations for X12 and EDIFACT document exchange.
+  x-celigo-ai-guidance:
+    - |-
+      EDI profiles define the interchange envelope configuration for EDI X12 and
+      EDIFACT document exchange between trading partners.
+      They contain the control fields (ISA/GS for X12,
+      UNB for EDIFACT) that identify sender/receiver, standards versions,
+      and interchange control settings.
+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: EDI Profiles
+    description: |-
+      API for managing EDI profiles in Celigo.
+
+      EDI profiles define the interchange envelope configuration for EDI X12 and
+      EDIFACT document exchange between trading partners. They contain the control
+      fields (ISA/GS for X12, UNB for EDIFACT) that identify sender/receiver,
+      standards versions, and interchange control settings.
+
+      ## EDI profile schema
+
+      {% openapi-schemas spec="ediprofile" schemas="EDIProfile" grouped="true" %}
+paths:
+  /v1/ediprofiles:
+    get:
+      x-internal: false
+      summary: List EDI profiles
+      description: Returns all EDI profiles configured in the account.
+      x-celigo-ai-guidance:
+        - |-
+          Returns a list of all EDI profiles configured in the account.
+          If no EDI profiles exist, a 204 response with no body will be returned.
+      operationId: listEDIProfiles
+      tags:
+        - EDI Profiles
+      responses:
+        '200':
+          description: Successfully retrieved list of EDI profiles
+          headers:
+            Link:
+              description: |
+                RFC-5988 pagination links. When more pages remain, includes a `<...>; rel="next"` entry;
+                absent on the final page.
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/EDIProfile'
+              examples:
+                default:
+                  value:
+                    - _id: 690146d901d66a7545038179
+                      lastModified: '2026-05-02T18:10:01.832Z'
+                      name: Dyno
+                      fileType: edix12
+                      tpInterchangeId: '9253390501'
+                      myInterchangeId: KOMAR3PL
+                      controlNumber: 1
+                      isa01: '00'
+                      isa03: '00'
+                      tpIdQualifier: '08'
+                      myIdQualifier: ZZ
+                      isa11: U
+                      isa12: '00401'
+                      isa14: '0'
+                      isa15: T
+                      isa16: ':'
+                      tpGroupId: '9253390501'
+                      myGroupId: KOMAR3PL
+                      gs07: T
+                      gs08: 004010UCS
+                    - _id: 689e2e2c11a53a05a0337115
+                      lastModified: '2025-08-14T18:51:52.968Z'
+                      name: Amazon.eu
+                      fileType: edifact
+                      tpInterchangeId: '49494949494'
+                      myInterchangeId: '12345678911'
+                      controlNumber: 1
+                      unb010_0001: UNOA
+                      unb010_0002: '1'
+                      tpIdQualifier: ZZZ
+                      myIdQualifier: ZZZ
+                      versionNumber: 96A
+                      controllingAgency: EU
+        '204':
+          description: No EDI profiles exist in the account
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+    post:
+      x-internal: false
+      summary: Create an EDI profile
+      description: |-
+        Creates a new EDI profile for EDI X12 or EDIFACT document exchange.
+        `fileType` is immutable after creation. Only `name` and `fileType`
+        are required; all ISA/GS/UNB control fields default to safe values.
+      x-celigo-ai-guidance:
+        - |-
+          The `fileType` field is immutable after creation and determines which set of
+          interchange control fields are available: `edix12` (X12 ISA/GS segments) or
+          `edifact` (EDIFACT UNB segment). Send the enum value (`edix12`/`edifact`),
+          not the standard name (`X12`/`EDIFACT`).
+      operationId: createEDIProfile
+      tags:
+        - EDI Profiles
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              x12-minimal:
+                summary: Minimal X12 profile
+                value:
+                  name: Acme Corp X12
+                  fileType: edix12
+              x12-full:
+                summary: X12 profile with interchange fields
+                value:
+                  name: Acme Corp X12
+                  fileType: edix12
+                  tpInterchangeId: ACMECORP
+                  myInterchangeId: MYCOMPANY
+                  tpIdQualifier: ZZ
+                  myIdQualifier: ZZ
+                  isa01: '00'
+                  isa03: '00'
+                  isa11: U
+                  isa12: '00501'
+                  isa14: '0'
+                  isa15: P
+                  isa16: '>'
+                  tpGroupId: ACME
+                  myGroupId: MYAPP
+                  gs07: X
+                  gs08: '005010'
+              edifact:
+                summary: EDIFACT profile
+                value:
+                  name: Partner EDIFACT
+                  fileType: edifact
+                  tpInterchangeId: '49494949494'
+                  myInterchangeId: '12345678911'
+                  tpIdQualifier: ZZZ
+                  myIdQualifier: ZZZ
+                  unb010_0001: UNOA
+                  unb010_0002: '1'
+                  versionNumber: D
+                  releaseNumber: 96A
+                  controllingAgency: UN
+      responses:
+        '201':
+          description: EDI profile created successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EDIProfile'
+              examples:
+                x12-minimal:
+                  summary: Created from the minimal X12 request
+                  value:
+                    _id: 5f8d43a1b9e5a80011a35f2c
+                    lastModified: '2026-06-09T17:30:12.481Z'
+                    name: Acme Corp X12
+                    fileType: edix12
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '422':
+          $ref: '#/components/responses/422-unprocessable-entity'
+  /v1/ediprofiles/{_id}:
+    get:
+      x-internal: false
+      summary: Get an EDI profile
+      description: Returns a specific EDI profile.
+      operationId: getEDIProfileById
+      tags:
+        - EDI Profiles
+      parameters:
+        - name: _id
+          in: path
+          description: The unique identifier of the EDI profile
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: ediprofiles
+            examples:
+              - 5f8d43a1b9e5a80011a35f2c
+      responses:
+        '200':
+          description: EDI profile retrieved successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EDIProfile'
+              examples:
+                x12:
+                  value:
+                    _id: 690146d901d66a7545038179
+                    lastModified: '2026-05-02T18:10:01.832Z'
+                    name: Dyno
+                    fileType: edix12
+                    tpInterchangeId: '9253390501'
+                    myInterchangeId: KOMAR3PL
+                    controlNumber: 1
+                    isa01: '00'
+                    isa03: '00'
+                    tpIdQualifier: '08'
+                    myIdQualifier: ZZ
+                    isa11: U
+                    isa12: '00401'
+                    isa14: '0'
+                    isa15: T
+                    isa16: ':'
+                    tpGroupId: '9253390501'
+                    myGroupId: KOMAR3PL
+                    gs07: T
+                    gs08: 004010UCS
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+    put:
+      x-internal: false
+      summary: Update an EDI profile
+      description: |-
+        Updates an existing EDI profile. `fileType` cannot be changed after
+        creation. Omitted fields are cleared to defaults.
+      operationId: updateEDIProfile
+      tags:
+        - EDI Profiles
+      parameters:
+        - name: _id
+          in: path
+          description: The unique identifier of the EDI profile
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: ediprofiles
+            examples:
+              - 5f8d43a1b9e5a80011a35f2c
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              partial:
+                summary: Update interchange IDs only
+                value:
+                  name: Dyno
+                  fileType: edix12
+                  tpInterchangeId: '9253390501'
+                  myInterchangeId: KOMAR3PL
+      responses:
+        '200':
+          description: EDI profile updated successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EDIProfile'
+              examples:
+                x12:
+                  summary: Updated X12 profile
+                  value:
+                    _id: 690146d901d66a7545038179
+                    lastModified: '2026-05-12T09:21:14.005Z'
+                    name: Dyno
+                    fileType: edix12
+                    tpInterchangeId: '9253390501'
+                    myInterchangeId: KOMAR3PL
+                    controlNumber: 1
+                    isa01: '00'
+                    isa03: '00'
+                    tpIdQualifier: '08'
+                    myIdQualifier: ZZ
+                    isa11: U
+                    isa12: '00401'
+                    isa14: '0'
+                    isa15: T
+                    isa16: ':'
+                    tpGroupId: '9253390501'
+                    myGroupId: KOMAR3PL
+                    gs07: T
+                    gs08: 004010UCS
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+    delete:
+      x-internal: false
+      summary: Delete an EDI profile
+      description: Deletes an EDI profile. Soft-deleted and retained for 30 days.
+      operationId: deleteEDIProfile
+      tags:
+        - EDI Profiles
+      parameters:
+        - name: _id
+          in: path
+          description: The unique identifier of the EDI profile
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: ediprofiles
+            examples:
+              - 5f8d43a1b9e5a80011a35f2c
+      responses:
+        '204':
+          description: EDI profile deleted successfully
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+        '422':
+          $ref: '#/components/responses/422-dependency-conflict'
+  /v1/ediprofiles/{_id}/dependencies:
+    get:
+      x-internal: false
+      operationId: listEdiProfileDependencies
+      tags:
+        - EDI Profiles
+      summary: List dependencies of an EDI profile
+      description: |-
+        Returns the set of resources that depend on the specified resource.
+        The response is an object whose keys are dependent-resource types
+        (e.g. `flows`, `imports`) and whose values are arrays of dependency
+        entries. Returns `{}` when no dependents exist, including for
+        well-formatted but nonexistent IDs.
+      parameters:
+        - name: _id
+          in: path
+          required: true
+          description: Resource ID.
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: ediprofiles
+            examples:
+              - 5f8d43a1b9e5a80011a35f2c
+      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
+  schemas:
+    EDIProfileBase:
+      type: object
+      description: Writable EDI profile fields shared by the request and response schemas.
+      properties:
+        name:
+          type: string
+          description: Human-readable name for the EDI profile
+          x-celigo-ai-guidance:
+            - Name the profile after the trading partner and EDI standard whose interchange identity it carries (e.g. "Acme Corp X12 Profile"), not after a flow's purpose — one partner's profile is reused by every document exchange with that partner.
+          examples:
+            - Acme Corp X12 Profile
+            - Partner EDIFACT Profile
+        description:
+          type: string
+          description: Detailed description of the EDI profile's purpose
+          examples:
+            - X12 interchange profile for Acme Corp trading partner
+        fileType:
+          type: string
+          enum:
+            - edix12
+            - edifact
+          x-enumDescriptions:
+            edix12: ANSI X12 EDI standard using ISA/GS envelope segments.
+            edifact: UN/EDIFACT EDI standard using UNB envelope segments.
+          description: The EDI standard this profile is configured for. Immutable after creation.
+          examples:
+            - edix12
+            - edifact
+        tpInterchangeId:
+          type: string
+          description: Trading partner's interchange identifier (ISA06 for X12, UNB sender/receiver ID for EDIFACT)
+          examples:
+            - ACMECORP
+            - '5412345678901'
+        myInterchangeId:
+          type: string
+          description: Your (sender/receiver) interchange identifier
+          examples:
+            - MYCOMPANY
+            - '1234567890123'
+        controlNumber:
+          type: integer
+          minimum: 1
+          maximum: 999999999
+          default: 1
+          description: Current interchange control number. Incremented with each interchange sent.
+          examples:
+            - 1
+            - 1001
+        isa01:
+          type: string
+          enum:
+            - '00'
+            - '01'
+            - '02'
+            - '03'
+            - '04'
+            - '05'
+          x-enumDescriptions:
+            '00': No authorization information present.
+            '01': Authorization type 01.
+            '02': Authorization type 02.
+            '03': Authorization type 03.
+            '04': Authorization type 04.
+            '05': Authorization type 05.
+          description: X12 ISA01 — Authorization Information Qualifier.
+          x-celigo-ai-guidance:
+            - |-
+              - 00: No authorization information present
+              - 01-05: Various authorization types
+          examples:
+            - '00'
+        isa02:
+          type: string
+          description: X12 ISA02 - Authorization Information (10 characters)
+          examples:
+            - '          '
+        isa03:
+          type: string
+          enum:
+            - '00'
+            - '01'
+          x-enumDescriptions:
+            '00': No security information present.
+            '01': Password-based security.
+          description: X12 ISA03 — Security Information Qualifier.
+          examples:
+            - '00'
+        isa04:
+          type: string
+          description: X12 ISA04 - Security Information (10 characters)
+          examples:
+            - '          '
+        tpIdQualifier:
+          type: string
+          description: |
+            Trading partner ID qualifier.
+
+            For X12 (ISA05/ISA07): Values include 01 (DUNS), 08 (UCC EDI), 12 (phone),
+            14 (DUNS+4), ZZ (mutually defined), etc.
+
+            For EDIFACT: Values include 14 (EAN), ZZZ (mutually defined), etc.
+          examples:
+            - ZZ
+            - '01'
+            - '14'
+        myIdQualifier:
+          type: string
+          description: |
+            Your (sender/receiver) ID qualifier. Same enum as tpIdQualifier.
+          examples:
+            - ZZ
+            - '01'
+            - '14'
+        isa11:
+          type: string
+          description: |
+            X12 ISA11 - Repetition Separator (or Interchange Control Standards Identifier
+            in older versions). Single character.
+          examples:
+            - U
+            - ^
+        isa12:
+          type: string
+          description: X12 ISA12 - Interchange Control Version Number (5 characters)
+          examples:
+            - '00401'
+            - '00501'
+        isa14:
+          type: string
+          enum:
+            - '0'
+            - '1'
+          x-enumDescriptions:
+            '0': No interchange acknowledgment requested.
+            '1': Interchange acknowledgment requested (TA1).
+          description: X12 ISA14 — Acknowledgment Requested.
+          examples:
+            - '0'
+            - '1'
+        isa15:
+          type: string
+          enum:
+            - P
+            - T
+          x-enumDescriptions:
+            P: Production data interchange.
+            T: Test data interchange.
+          description: X12 ISA15 — Interchange Usage Indicator.
+          examples:
+            - P
+            - T
+        isa16:
+          type: string
+          description: X12 ISA16 - Component Element Separator. Single character.
+          examples:
+            - '>'
+            - ':'
+        tpGroupId:
+          type: string
+          description: X12 GS02 - Trading partner's application sender/receiver code
+          examples:
+            - ACME
+        myGroupId:
+          type: string
+          description: X12 GS03 - Your application sender/receiver code
+          examples:
+            - MYAPP
+        gs07:
+          type: string
+          enum:
+            - X
+            - T
+          x-enumDescriptions:
+            X: Accredited Standards Committee X12.
+            T: Transportation Data Coordinating Committee.
+          description: X12 GS07 — Responsible Agency Code.
+          examples:
+            - X
+        gs08:
+          type: string
+          description: X12 GS08 - Version/Release/Industry Identifier Code
+          examples:
+            - '004010'
+            - '005010'
+        unb010_0001:
+          type: string
+          enum:
+            - UNOA
+            - UNOB
+            - UNOC
+            - UNOD
+            - UNOE
+            - UNOF
+          x-enumDescriptions:
+            UNOA: Level A character set (uppercase letters, digits, and basic punctuation).
+            UNOB: Level B character set (Level A plus lowercase letters).
+            UNOC: Level C character set (ISO 8859-1 Latin-1).
+            UNOD: Level D character set (ISO 8859-2 Latin-2).
+            UNOE: Level E character set (ISO 8859-5 Cyrillic).
+            UNOF: Level F character set (ISO 8859-7 Greek).
+          description: |
+            EDIFACT UNB S001/0001 - Syntax Identifier.
+            Identifies the character set used in the interchange.
+          examples:
+            - UNOB
+        unb010_0002:
+          type: string
+          enum:
+            - '1'
+            - '2'
+            - '3'
+          x-enumDescriptions:
+            '1': EDIFACT syntax version 1.
+            '2': EDIFACT syntax version 2.
+            '3': EDIFACT syntax version 3.
+          description: |
+            EDIFACT UNB S001/0002 - Syntax Version Number.
+          examples:
+            - '3'
+        versionNumber:
+          type: string
+          description: |
+            EDIFACT message version number (e.g., "D" for directory).
+          examples:
+            - D
+        releaseNumber:
+          type: string
+          description: |
+            EDIFACT message release number.
+          examples:
+            - 96A
+            - 01B
+            - 14A
+        controllingAgency:
+          type: string
+          description: |
+            EDIFACT controlling agency code.
+          examples:
+            - UN
+            - EC
+            - AA
+    ResourceResponse:
+      type: object
+      description: Response
+      x-celigo-ai-guidance:
+        - Core response fields shared by all Celigo resources
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          description: Unique identifier for the resource. Format is a 24-character hexadecimal string.
+          x-celigo-ai-guidance:
+            - |-
+              The _id is used in:
+              - API endpoints that operate on a specific resource (e.g., GET, PUT, DELETE)
+              - References from other resources (e.g., flows that use this resource)
+              - Job history and error tracking
+          examples:
+            - 5f8d43a1b9e5a80011a35f2c
+        createdAt:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the resource was created. Set automatically and cannot be modified.
+          x-celigo-ai-guidance:
+            - Recorded in ISO 8601 with a UTC timezone (Z suffix).
+          examples:
+            - '2023-04-01T09:15:32Z'
+        lastModified:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the resource was last updated. Changes whenever any property is modified.
+          x-celigo-ai-guidance:
+            - Recorded in ISO 8601 with a UTC timezone (Z suffix); always equal to or later than `createdAt`.
+          examples:
+            - '2023-04-15T14:30:15Z'
+        deletedAt:
+          type:
+            - string
+            - 'null'
+          format: date-time
+          readOnly: true
+          description: Timestamp when the resource was soft-deleted. When null or absent, the resource is active.
+          x-celigo-ai-guidance:
+            - Non-null means the resource is soft-deleted (in the recycle bin) — recoverable within the retention period before permanent removal.
+          examples:
+            - '2023-05-20T11:45:32Z'
+      required:
+        - _id
+    EDIProfile:
+      type: object
+      required:
+        - _id
+        - name
+        - fileType
+        - lastModified
+      description: EDI profile with metadata and interchange control fields.
+      allOf:
+        - $ref: '#/components/schemas/EDIProfileBase'
+        - $ref: '#/components/schemas/ResourceResponse'
+        - type: object
+          properties:
+            _templateId:
+              type: string
+              format: objectId
+              readOnly: true
+              x-celigo-refModel: templates
+              description: Template this EDI profile was installed from.
+              examples:
+                - 5f8d43a1b9e5a80011a35f2c
+            _sourceId:
+              type: string
+              format: objectId
+              readOnly: true
+              description: Original profile ID when cloned or installed from a template.
+              examples:
+                - 5f8d43a1b9e5a80011a35f2c
+      x-celigo-ai-guidance:
+        - |-
+          Contains the complete EDI profile configuration including metadata and
+          all interchange control fields for the configured file type (X12 or EDIFACT).
+    Request:
+      type: object
+      description: |-
+        EDI profile configuration. The `fileType` field determines which set of
+        interchange control fields apply (X12 ISA/GS or EDIFACT UNB) and is
+        immutable after creation. Fields for the other standard are ignored.
+      x-celigo-ai-guidance:
+        - Request schema for creating or updating an EDI profile.
+      required:
+        - name
+        - fileType
+      allOf:
+        - $ref: '#/components/schemas/EDIProfileBase'
+    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
+    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