@celigo/api-specs 0.2.1

package/dist/httpconnector.yml

@@ -0,0 +1,2277 @@
+openapi: 3.2.0
+info:
+  version: 1.0.0
+  title: HTTP Connectors
+  description: API for managing Celigo HTTP Connectors — reusable API framework definitions inherited by HTTP connections, imports, and exports.
+  x-celigo-ai-guidance:
+    - |-
+      API for managing HTTP Connector framework resources in Celigo.
+      HTTP Connectors define versioned API frameworks (base URIs, versioning strategy,
+      supported-by rules) that can be used by HTTP connections, iClients, imports, and exports.
+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: HTTP Connectors
+    description: |-
+      HTTP Connectors define reusable API frameworks — base URIs, versioning
+      strategies, authentication presets, and supported-by rules — that
+      HTTP connections, iClients, imports, and exports inherit.
+
+      Each connector has one or more versions and may group multiple API
+      products under `apis[]`. Child resources (HTTP Connector Resources
+      and Endpoints) define the specific operations available.
+
+      Two structural patterns exist:
+      - **Flat** — versions and baseURIs sit directly on the connector.
+        Most connectors use this pattern.
+      - **Grouped** — the connector nests API products under `apis[]`,
+        each with its own versions and baseURIs.
+
+      ## HTTP connector schema
+
+      {% openapi-schemas spec="httpconnector" schemas="HTTPConnector" grouped="true" %}
+paths:
+  /v1/httpconnectors:
+    get:
+      x-internal: false
+      operationId: listHttpConnectors
+      tags:
+        - HTTP Connectors
+      summary: List HTTP connectors
+      description: |-
+        Returns all HTTP Connectors visible to the authenticated account.
+        The list response is abridged -- it omits `published`, `baseURIs`,
+        `supportedBy`, and other detail fields. Use the by-ID endpoint for
+        the full object.
+      parameters:
+        - name: publishedOnly
+          in: query
+          description: When true, only return published HTTP Connectors.
+          schema:
+            type: boolean
+      responses:
+        '200':
+          description: Successfully retrieved list of HTTP Connectors.
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/ListItem'
+              examples:
+                two_connectors:
+                  value:
+                    - _id: 63987132784a39b73aae63cd
+                      name: 15Five
+                      createdAt: '2023-01-17T09:51:46.326Z'
+                      lastModified: '2025-09-02T09:15:49.168Z'
+                      _userId: 6316f2b1e37e79778a43391c
+                      helpURL: https://docs.celigo.com/hc/en-us/articles/4411468706203
+                      legacyId: 15five
+                      legacyIds:
+                        - 15five
+                      isGraphQL: false
+                      supportsIClient: false
+                      hasBlobEndpoints: false
+                      versions:
+                        - _id: 63987132784a39b73aae63ce
+                          name: v1
+                    - _id: 6a1b2c3d4e5f6789abcdef01
+                      name: AFAS ERP
+                      createdAt: '2025-10-28T13:32:39.999Z'
+                      lastModified: '2025-11-12T08:56:03.102Z'
+                      _userId: 6316f2b1e37e79778a43391c
+                      helpURL: https://docs.celigo.com/hc/en-us/articles/42612451102235
+                      isGraphQL: false
+                      supportsIClient: true
+                      hasBlobEndpoints: false
+                      apis:
+                        - _id: 6a1b2c3d4e5f6789abcdef02
+                          name: Profit
+                          versions:
+                            - _id: 6a1b2c3d4e5f6789abcdef03
+                              name: v1
+        '204':
+          description: No HTTP Connectors match the filter criteria.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+    post:
+      x-internal: false
+      operationId: createHttpConnector
+      tags:
+        - HTTP Connectors
+      summary: Create an HTTP connector
+      description: |-
+        Creates a new HTTP Connector framework definition. `name` is
+        required, along with either `versions` (flat connector) or `apis`
+        (grouped connector).
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              flat_connector:
+                summary: Flat connector with one version
+                value:
+                  name: Acme API
+                  baseURIs:
+                    - https://api.acme.com
+                  versions:
+                    - name: v1
+                      published: true
+                  supportedBy:
+                    connection:
+                      preConfiguredFields:
+                        - path: type
+                          values:
+                            - http
+      responses:
+        '201':
+          description: HTTP Connector created successfully.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnector'
+              examples:
+                created:
+                  summary: Created connector (detail shape)
+                  value:
+                    _id: 63987132784a39b73aae63cd
+                    _userId: 6316f2b1e37e79778a43391c
+                    name: 15Five
+                    createdAt: '2023-01-17T09:51:46.326Z'
+                    lastModified: '2023-01-17T09:51:46.326Z'
+                    published: true
+                    isGraphQL: false
+                    requireBodyMatchForLinking: false
+                    disableAutoLinking: false
+                    baseURIs:
+                      - https://my.15five.com
+                    helpURL: https://docs.celigo.com/hc/en-us/articles/4411468706203
+                    legacyId: 15five
+                    versions:
+                      - _id: 63987132784a39b73aae63ce
+                        name: v1
+                        published: true
+                        supportedBy: {}
+                    apis: []
+                    supportedBy:
+                      export:
+                        preConfiguredFields:
+                          - path: successMediaType
+                            values:
+                              - json
+                      connection:
+                        preConfiguredFields:
+                          - path: type
+                            values:
+                              - http
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '422':
+          $ref: '#/components/responses/422-unprocessable-entity'
+  /v1/httpconnectors/{_id}:
+    get:
+      x-internal: false
+      operationId: getHttpConnectorById
+      tags:
+        - HTTP Connectors
+      summary: Get an HTTP connector
+      description: |-
+        Retrieves the full HTTP Connector object including `published`,
+        `baseURIs`, `supportedBy`, and version details omitted from the
+        list endpoint.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+          description: HTTP Connector ID.
+      responses:
+        '200':
+          description: HTTP Connector retrieved successfully.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnector'
+              examples:
+                detail:
+                  value:
+                    _id: 63987132784a39b73aae63cd
+                    _userId: 6316f2b1e37e79778a43391c
+                    name: 15Five
+                    createdAt: '2023-01-17T09:51:46.326Z'
+                    lastModified: '2025-09-02T09:15:49.168Z'
+                    published: true
+                    isGraphQL: false
+                    requireBodyMatchForLinking: false
+                    disableAutoLinking: false
+                    baseURIs:
+                      - https://my.15five.com
+                    helpURL: https://docs.celigo.com/hc/en-us/articles/4411468706203
+                    legacyId: 15five
+                    versions:
+                      - _id: 63987132784a39b73aae63ce
+                        name: v1
+                        published: true
+                        supportedBy: {}
+                    apis: []
+                    supportedBy:
+                      export:
+                        preConfiguredFields:
+                          - path: successMediaType
+                            values:
+                              - json
+                      connection:
+                        preConfiguredFields:
+                          - path: type
+                            values:
+                              - http
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+    put:
+      x-internal: false
+      operationId: updateHttpConnector
+      tags:
+        - HTTP Connectors
+      summary: Update an HTTP connector
+      description: Replaces the HTTP Connector with the provided fields.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+          description: HTTP Connector ID.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              full_replace:
+                summary: Full replace disabling auto-linking
+                value:
+                  name: 15Five
+                  published: true
+                  isGraphQL: false
+                  requireBodyMatchForLinking: false
+                  disableAutoLinking: true
+                  baseURIs:
+                    - https://my.15five.com
+                  helpURL: https://docs.celigo.com/hc/en-us/articles/4411468706203
+                  legacyId: 15five
+                  versions:
+                    - name: v1
+                      published: true
+                  supportedBy:
+                    export:
+                      preConfiguredFields:
+                        - path: successMediaType
+                          values:
+                            - json
+                    connection:
+                      preConfiguredFields:
+                        - path: type
+                          values:
+                            - http
+      responses:
+        '200':
+          description: HTTP Connector updated successfully.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnector'
+              examples:
+                updated:
+                  summary: Updated connector
+                  value:
+                    _id: 63987132784a39b73aae63cd
+                    _userId: 6316f2b1e37e79778a43391c
+                    name: 15Five
+                    createdAt: '2023-01-17T09:51:46.326Z'
+                    lastModified: '2025-09-10T11:42:17.553Z'
+                    published: true
+                    isGraphQL: false
+                    requireBodyMatchForLinking: false
+                    disableAutoLinking: true
+                    baseURIs:
+                      - https://my.15five.com
+                    helpURL: https://docs.celigo.com/hc/en-us/articles/4411468706203
+                    legacyId: 15five
+                    versions:
+                      - _id: 63987132784a39b73aae63ce
+                        name: v1
+                        published: true
+                        supportedBy: {}
+                    apis: []
+                    supportedBy:
+                      export:
+                        preConfiguredFields:
+                          - path: successMediaType
+                            values:
+                              - json
+                      connection:
+                        preConfiguredFields:
+                          - path: type
+                            values:
+                              - http
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+        '422':
+          $ref: '#/components/responses/422-unprocessable-entity'
+    delete:
+      x-internal: false
+      operationId: deleteHttpConnector
+      tags:
+        - HTTP Connectors
+      summary: Delete an HTTP connector
+      description: |-
+        Permanently deletes an HTTP Connector and all its child resources
+        and endpoints.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+          description: HTTP Connector ID.
+      responses:
+        '204':
+          description: HTTP Connector deleted successfully.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+  /v1/httpconnectors/{_id}/catalog:
+    get:
+      x-internal: false
+      operationId: getHttpConnectorCatalog
+      tags:
+        - HTTP Connectors
+      summary: Get form metadata catalog
+      description: |-
+        Returns projected resource and endpoint summaries for one import or export
+        plane. Import catalogs may include derived `ignoreExisting`, `ignoreMissing`,
+        and `isIdentifierPresent` flags on endpoints. Export catalogs return
+        endpoint `{ id, name }` only. Published-only requests may be served from
+        the MongoDB catalog cache and include an `X-Catalog-Cache` response header.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectors
+            examples:
+              - 63987132784a39b73aae63cd
+          description: HTTP Connector ID.
+        - name: resourceType
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - export
+              - import
+            x-enumDescriptions:
+              export: Return export-plane resources and endpoints
+              import: Return import-plane resources and endpoints
+          description: Resource plane to project.
+        - name: blob
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only blob endpoints match
+              'false': Only non-blob endpoints match
+          description: Selects the blob or non-blob endpoint plane.
+        - name: api
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 6a1b2c3d4e5f6789abcdef02
+          description: Optional API group scope filter.
+        - name: version
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63ce
+          description: Optional version scope filter.
+        - name: publishedOnly
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only published connector, resource, and endpoint documents are returned
+              'false': Unpublished documents may be returned
+          description: |-
+            When `true`, only published documents are returned and eligible requests
+            may be served from the catalog cache.
+      responses:
+        '200':
+          description: Form metadata catalog retrieved successfully.
+          headers:
+            X-Catalog-Cache:
+              description: |-
+                Catalog cache status for eligible published-only requests. Absent
+                when the request is not cache-eligible.
+              schema:
+                type: string
+                enum:
+                  - hit
+                  - miss
+                x-enumDescriptions:
+                  hit: Response body was served from the MongoDB catalog cache
+                  miss: Response body was built from source collections
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnectorCatalogResponse'
+              examples:
+                export_catalog:
+                  summary: Export-plane catalog
+                  value:
+                    resources:
+                      - id: 63987132784a39b73aae63e7
+                        name: Orders
+                        endpoints:
+                          - id: 63987132784a39b73aae63f1
+                            name: Get orders
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+  /v1/httpconnectors/{_id}/resourceEndpointDetail:
+    get:
+      x-internal: false
+      operationId: getHttpConnectorResourceEndpointDetail
+      tags:
+        - HTTP Connectors
+      summary: Get resource and endpoint detail
+      description: |-
+        Returns scoped `httpConnectorResource` and `httpConnectorEndpoint`
+        documents for a single export/import endpoint, or a paired import
+        create/update batch. Lookup endpoints may be inlined when they are
+        published and belong to the same connector. `endpointId` and
+        `endpointIds` are mutually exclusive; `endpointIds` is only valid when
+        `resourceType` is `import` and must contain exactly two comma-separated
+        ObjectIds. Composite `id1+id2` values are rejected.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectors
+            examples:
+              - 63987132784a39b73aae63cd
+          description: HTTP Connector ID.
+        - name: resourceType
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - export
+              - import
+            x-enumDescriptions:
+              export: Resolve an export-plane resource and endpoint
+              import: Resolve an import-plane resource and endpoint
+          description: Resource plane to resolve.
+        - name: resourceId
+          in: query
+          required: true
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63e7
+          description: HTTP Connector Resource ID that belongs to this connector.
+        - name: blob
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only blob endpoints match
+              'false': Only non-blob endpoints match
+          description: Selects the blob or non-blob endpoint plane.
+        - name: endpointId
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63f1
+          description: Single endpoint ID. Mutually exclusive with `endpointIds`.
+        - name: endpointIds
+          in: query
+          required: false
+          schema:
+            type: string
+            examples:
+              - 63987132784a39b73aae63f1,63987132784a39b73aae63f2
+          description: |-
+            Comma-separated pair of import endpoint IDs for create/update batch
+            mode. Import only; exactly two unique IDs. Mutually exclusive with
+            `endpointId`.
+        - name: api
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 6a1b2c3d4e5f6789abcdef02
+          description: Optional API group scope filter.
+        - name: version
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63ce
+          description: Optional version scope filter; echoed as `resolvedVersionId` when present.
+        - name: publishedOnly
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only published connector, resource, and endpoint documents are returned
+              'false': Unpublished documents may be returned
+          description: When `true`, only published documents are returned.
+      responses:
+        '200':
+          description: Resource and endpoint detail retrieved successfully.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ResourceEndpointDetail'
+              examples:
+                single_export:
+                  summary: Single export endpoint
+                  value:
+                    resolvedResourceId: 63987132784a39b73aae63e7
+                    resolvedEndpointId: 63987132784a39b73aae63f1
+                    httpConnectorResource:
+                      _id: 63987132784a39b73aae63e7
+                      name: Orders
+                    httpConnectorEndpoint:
+                      _id: 63987132784a39b73aae63f1
+                      name: Get orders
+                import_batch:
+                  summary: Import create/update batch
+                  value:
+                    resolvedResourceId: 63987132784a39b73aae63e7
+                    resolvedEndpointIds:
+                      - 63987132784a39b73aae63f1
+                      - 63987132784a39b73aae63f2
+                    httpConnectorResource:
+                      _id: 63987132784a39b73aae63e7
+                      name: Orders
+                    httpConnectorEndpoints:
+                      - _id: 63987132784a39b73aae63f1
+                        name: Create order
+                      - _id: 63987132784a39b73aae63f2
+                        name: Update order
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+  /api/httpconnectors/{_id}/catalog:
+    get:
+      x-internal: false
+      operationId: getHttpConnectorCatalog
+      tags:
+        - HTTP Connectors
+      summary: Get form metadata catalog
+      description: |-
+        Returns projected resource and endpoint summaries for one import or export
+        plane. Import catalogs may include derived `ignoreExisting`, `ignoreMissing`,
+        and `isIdentifierPresent` flags on endpoints. Export catalogs return
+        endpoint `{ id, name }` only. Published-only requests may be served from
+        the MongoDB catalog cache and include an `X-Catalog-Cache` response header.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectors
+            examples:
+              - 63987132784a39b73aae63cd
+          description: HTTP Connector ID.
+        - name: resourceType
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - export
+              - import
+            x-enumDescriptions:
+              export: Return export-plane resources and endpoints
+              import: Return import-plane resources and endpoints
+          description: Resource plane to project.
+        - name: blob
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only blob endpoints match
+              'false': Only non-blob endpoints match
+          description: Selects the blob or non-blob endpoint plane.
+        - name: api
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 6a1b2c3d4e5f6789abcdef02
+          description: Optional API group scope filter.
+        - name: version
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63ce
+          description: Optional version scope filter.
+        - name: publishedOnly
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only published connector, resource, and endpoint documents are returned
+              'false': Unpublished documents may be returned
+          description: |-
+            When `true`, only published documents are returned and eligible requests
+            may be served from the catalog cache.
+      responses:
+        '200':
+          description: Form metadata catalog retrieved successfully.
+          headers:
+            X-Catalog-Cache:
+              description: |-
+                Catalog cache status for eligible published-only requests. Absent
+                when the request is not cache-eligible.
+              schema:
+                type: string
+                enum:
+                  - hit
+                  - miss
+                x-enumDescriptions:
+                  hit: Response body was served from the MongoDB catalog cache
+                  miss: Response body was built from source collections
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnectorCatalogResponse'
+              examples:
+                export_catalog:
+                  summary: Export-plane catalog
+                  value:
+                    resources:
+                      - id: 63987132784a39b73aae63e7
+                        name: Orders
+                        endpoints:
+                          - id: 63987132784a39b73aae63f1
+                            name: Get orders
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+  /api/httpconnectors/{_id}/resourceEndpointDetail:
+    get:
+      x-internal: false
+      operationId: getHttpConnectorResourceEndpointDetail
+      tags:
+        - HTTP Connectors
+      summary: Get resource and endpoint detail
+      description: |-
+        Returns scoped `httpConnectorResource` and `httpConnectorEndpoint`
+        documents for a single export/import endpoint, or a paired import
+        create/update batch. Lookup endpoints may be inlined when they are
+        published and belong to the same connector. `endpointId` and
+        `endpointIds` are mutually exclusive; `endpointIds` is only valid when
+        `resourceType` is `import` and must contain exactly two comma-separated
+        ObjectIds. Composite `id1+id2` values are rejected.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectors
+            examples:
+              - 63987132784a39b73aae63cd
+          description: HTTP Connector ID.
+        - name: resourceType
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - export
+              - import
+            x-enumDescriptions:
+              export: Resolve an export-plane resource and endpoint
+              import: Resolve an import-plane resource and endpoint
+          description: Resource plane to resolve.
+        - name: resourceId
+          in: query
+          required: true
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63e7
+          description: HTTP Connector Resource ID that belongs to this connector.
+        - name: blob
+          in: query
+          required: true
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only blob endpoints match
+              'false': Only non-blob endpoints match
+          description: Selects the blob or non-blob endpoint plane.
+        - name: endpointId
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63f1
+          description: Single endpoint ID. Mutually exclusive with `endpointIds`.
+        - name: endpointIds
+          in: query
+          required: false
+          schema:
+            type: string
+            examples:
+              - 63987132784a39b73aae63f1,63987132784a39b73aae63f2
+          description: |-
+            Comma-separated pair of import endpoint IDs for create/update batch
+            mode. Import only; exactly two unique IDs. Mutually exclusive with
+            `endpointId`.
+        - name: api
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 6a1b2c3d4e5f6789abcdef02
+          description: Optional API group scope filter.
+        - name: version
+          in: query
+          required: false
+          schema:
+            type: string
+            format: objectId
+            examples:
+              - 63987132784a39b73aae63ce
+          description: Optional version scope filter; echoed as `resolvedVersionId` when present.
+        - name: publishedOnly
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - 'true'
+              - 'false'
+            x-enumDescriptions:
+              'true': Only published connector, resource, and endpoint documents are returned
+              'false': Unpublished documents may be returned
+          description: When `true`, only published documents are returned.
+      responses:
+        '200':
+          description: Resource and endpoint detail retrieved successfully.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ResourceEndpointDetail'
+              examples:
+                single_export:
+                  summary: Single export endpoint
+                  value:
+                    resolvedResourceId: 63987132784a39b73aae63e7
+                    resolvedEndpointId: 63987132784a39b73aae63f1
+                    httpConnectorResource:
+                      _id: 63987132784a39b73aae63e7
+                      name: Orders
+                    httpConnectorEndpoint:
+                      _id: 63987132784a39b73aae63f1
+                      name: Get orders
+                import_batch:
+                  summary: Import create/update batch
+                  value:
+                    resolvedResourceId: 63987132784a39b73aae63e7
+                    resolvedEndpointIds:
+                      - 63987132784a39b73aae63f1
+                      - 63987132784a39b73aae63f2
+                    httpConnectorResource:
+                      _id: 63987132784a39b73aae63e7
+                      name: Orders
+                    httpConnectorEndpoints:
+                      - _id: 63987132784a39b73aae63f1
+                        name: Create order
+                      - _id: 63987132784a39b73aae63f2
+                        name: Update order
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+components:
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+  schemas:
+    ListItem:
+      type: object
+      description: |-
+        Abridged HTTP Connector returned in list responses. Omits `published`,
+        `baseURIs`, `supportedBy`, `apis`, `versioning`, and write-only fields
+        compared to the detail endpoint.
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          x-celigo-refModel: httpconnectors
+          description: Unique identifier for the resource. Format is a 24-character hexadecimal string.
+          examples:
+            - 63987132784a39b73aae63cd
+        name:
+          type: string
+          description: Display name for this HTTP Connector.
+          examples:
+            - 15Five
+        _userId:
+          type: string
+          format: objectId
+          readOnly: true
+          x-celigo-refModel: users
+          description: User who created this connector.
+          examples:
+            - 6316f2b1e37e79778a43391c
+        createdAt:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the resource was created. Set automatically and cannot be modified.
+          examples:
+            - '2023-01-17T09:51:46.326Z'
+        lastModified:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the resource was last updated. Changes whenever any property is modified.
+          examples:
+            - '2025-09-02T09:15:49.168Z'
+        helpURL:
+          type: string
+          description: Documentation URL shown to users when configuring this connector.
+          examples:
+            - https://docs.celigo.com/hc/en-us/articles/4411468706203
+        legacyId:
+          type: string
+          description: Legacy assistant ID for backward compatibility.
+          examples:
+            - 15five
+        legacyIds:
+          type: array
+          description: All legacy assistant IDs associated with this connector.
+          items:
+            type: string
+            examples:
+              - 15five
+          readOnly: true
+        isGraphQL:
+          type: boolean
+          description: When true, this connector targets a GraphQL API.
+        supportsIClient:
+          type: boolean
+          readOnly: true
+          description: When true, this connector supports shared iClient credentials.
+        supportsWebhook:
+          type: boolean
+          readOnly: true
+          description: When true, this connector supports webhook-based exports.
+        hasBlobEndpoints:
+          type: boolean
+          readOnly: true
+          description: When true, at least one endpoint under this connector handles binary/blob data.
+        metadataLoadStrategy:
+          type: string
+          enum:
+            - staged
+          readOnly: true
+          x-enumDescriptions:
+            staged: Form metadata is loaded via catalog and resourceEndpointDetail routes
+          description: |-
+            Present only when the connector uses staged metadata loading. Omitted
+            when the stored strategy is `full`.
+        versions:
+          type: array
+          description: Connector versions, abridged to identifiers and names.
+          items:
+            type: object
+            properties:
+              _id:
+                type: string
+                format: objectId
+                description: Unique identifier for this version.
+                examples:
+                  - 63987132784a39b73aae63ce
+              name:
+                type: string
+                description: Display name for this version (e.g. `v3`).
+                examples:
+                  - v3
+        apis:
+          type: array
+          description: API groups under this connector, abridged to identifiers, names, and versions.
+          items:
+            type: object
+            properties:
+              _id:
+                type: string
+                format: objectId
+                description: Unique identifier for this API group.
+                examples:
+                  - 6a1b2c3d4e5f6789abcdef02
+              name:
+                type: string
+                description: Display name for this API group.
+                examples:
+                  - Profit
+              versions:
+                type: array
+                description: Versions available under this API group.
+                items:
+                  type: object
+                  properties:
+                    _id:
+                      type: string
+                      format: objectId
+                      description: Unique identifier for this version.
+                      examples:
+                        - 6a1b2c3d4e5f6789abcdef03
+                    name:
+                      type: string
+                      description: Display name for this version (e.g. `v3`).
+                      examples:
+                        - v1
+    Versioning:
+      type: object
+      description: |-
+        Strategy for how API versions are passed in requests. Used at the
+        connector level and per API group; both use the same shape.
+      properties:
+        location:
+          type: string
+          enum:
+            - uri
+            - query_parameter
+            - header
+          x-enumDescriptions:
+            uri: Version identifier is embedded in the URI path.
+            query_parameter: Version identifier is passed as a query parameter.
+            header: Version identifier is passed in an HTTP header.
+          description: Where the version identifier is placed in outgoing requests.
+        headerName:
+          type: string
+          description: Header name when `location` is `header`.
+          examples:
+            - API-Version
+        queryParameterName:
+          type: string
+          description: Query parameter name when `location` is `query_parameter`.
+          examples:
+            - api-version
+    SupportedByPreConfiguredField:
+      type: object
+      description: A field automatically set to a predefined value on the target resource.
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          description: Unique identifier for this field entry.
+          examples:
+            - 5f8d43a1b9e5a80011a35f2d
+        path:
+          type: string
+          description: Dot-notation path of the field on the target resource.
+          examples:
+            - http.mediaType
+            - http.ping.relativeURI
+            - http.auth.type
+        values:
+          type: array
+          description: |-
+            Value(s) to assign. Typically a single-element array; entries may be
+            any JSON type.
+        _conditionIds:
+          type: array
+          description: Condition IDs that must be satisfied for this field to apply. If absent, always applies.
+          items:
+            type: string
+            format: objectId
+            examples:
+              - 5f8d43a1b9e5a80011a35f2c
+    SupportedByFieldUserMustSet:
+      type: object
+      description: A field the user must provide a value for when creating the target resource.
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          description: Unique identifier for this field entry.
+          examples:
+            - 5f8d43a1b9e5a80011a35f2e
+        path:
+          type: string
+          description: Dot-notation path of the field on the target resource.
+          examples:
+            - http.unencrypted.apiKey
+            - http.baseURI
+            - http.encrypted.password
+        values:
+          type: array
+          description: |-
+            Optional suggested or constrained values. Entries may be any JSON
+            type.
+        _conditionIds:
+          type: array
+          description: Condition IDs that must be satisfied for this field to apply.
+          items:
+            type: string
+            format: objectId
+            examples:
+              - 5f8d43a1b9e5a80011a35f2c
+        helpURL:
+          type: string
+          description: URL to documentation for this field.
+          examples:
+            - https://docs.celigo.com/hc/en-us
+        labelOverride:
+          type: string
+          description: Custom label to display in the UI instead of the default.
+          examples:
+            - API Key
+        inputType:
+          type: string
+          enum:
+            - number
+            - password
+            - uri
+          x-enumDescriptions:
+            number: Renders a numeric input field.
+            password: Renders a masked password input field.
+            uri: Renders a URI input field with URL validation.
+          description: |-
+            UI input widget type shown when prompting the user for this field.
+            Uses the same widget vocabulary as Trading Partner Connectors.
+          examples:
+            - password
+    Filter:
+      type: object
+      description: |
+        Configuration for selectively processing records based on specified criteria. This object enables
+        precise control over which items are included or excluded from processing operations.
+
+        **Filter behavior**
+
+        When configured, the filter is applied before processing begins:
+        - Items that match the filter criteria are processed
+        - Items that don't match are completely skipped
+        - No partial processing is performed
+
+        **Implementation approaches**
+
+        There are two distinct filtering mechanisms available:
+
+        **Rule-Based Filtering (`type: "expression"`)**
+        - **Best For**: Common filtering patterns based on standard attributes
+        - **Capabilities**: Filter by names, values, dates, numerical ranges, text patterns
+        - **Advantages**: Declarative, no coding required, consistent performance
+        - **Configuration**: Define rules in the `expression` object
+        - **Use When**: You have clear, static criteria for selection
+
+        **Script-Based Filtering (`type: "script"`)**
+        - **Best For**: Complex logic, dynamic criteria, or business rules
+        - **Capabilities**: Full programmatic control, access to complete metadata
+        - **Advantages**: Maximum flexibility, can implement any filtering logic
+        - **Configuration**: Reference a script in the `script` object
+        - **Use When**: Simple rules aren't sufficient or logic needs to be dynamic
+      properties:
+        type:
+          type: string
+          description: |
+            Determines which filtering mechanism to use. This choice affects which properties
+            must be configured and how filtering logic is implemented.
+
+            **Available types**
+
+            **Rule-Based Filtering (`"expression"`)**
+            - **Required Config**: The `expression` object with rule definitions
+            - **Behavior**: Evaluates declarative rules against item attributes
+            - **Best For**: Common patterns like name matching, date ranges, value limits
+            - **Advantages**: Simpler to configure, no custom code required
+
+            **Script-Based Filtering (`"script"`)**
+            - **Required Config**: The `script` object with _scriptId and function
+            - **Behavior**: Executes custom JavaScript to determine which items to process
+            - **Best For**: Complex conditions, business logic, dynamic criteria
+            - **Advantages**: Maximum flexibility, can implement any logic
+
+            **Implementation guidance**
+
+            1. For standard filtering needs (name, size, date), use `"expression"`
+            2. For complex logic or conditions not covered by expressions, use `"script"`
+            3. When selecting a type, you must configure the corresponding object:
+                - `type: "expression"` requires the `expression` object
+                - `type: "script"` requires the `script` object
+          enum:
+            - expression
+            - script
+          x-enumDescriptions:
+            expression: Rule-based filtering using declarative conditions.
+            script: Script-based filtering using custom JavaScript logic.
+          examples:
+            - expression
+            - script
+        expression:
+          type: object
+          description: |
+            Configuration for declarative rule-based filtering. This object enables filtering
+            items based on common attributes without requiring custom code.
+
+            **Usage context**
+
+            This object is REQUIRED when `filter.type` is set to "expression" and should not be
+            configured otherwise. It provides a standardized way to define filtering rules that
+            can match against item attributes like name, type, value, date, and other properties.
+
+            **Implementation guidance**
+
+            The expression system uses a rule-based approach where:
+            - Rules can be combined with AND/OR logic
+            - Each rule can check a specific attribute
+            - Multiple conditions can be applied (ranges, pattern matching, exact matches)
+
+            **Common filter patterns**
+
+            1. **Pattern matching**: Using wildcards like `*` and `?`
+            2. **Value range filtering**: Numbers between min and max values
+            3. **Date range filtering**: Items created/modified within specific time ranges
+            4. **Status checking**: Items with specific status values or properties
+
+            For AI agents: Rule-based filtering should be your first choice when the filtering criteria
+            can be expressed in terms of standard attributes. Only use script-based filtering when
+            more complex logic is required.
+          properties:
+            version:
+              type: string
+              description: |
+                Version identifier for the expression format. Currently only version "1" is supported.
+
+                This field ensures future compatibility if the expression format evolves. Always set to "1"
+                for current implementations.
+              enum:
+                - '1'
+              x-enumDescriptions:
+                '1': Current and only supported filter expression version.
+              examples:
+                - '1'
+            rules:
+              type: array
+              description: |
+                Expression array defining filter conditions using prefix notation. The first element is the operator,
+                followed by its operands which may themselves be nested expression arrays.
+
+                The rule expression follows this pattern:
+                - First element: Operator name (string)
+                - Remaining elements: Operands for that operator (values or nested expressions)
+
+                **Expression structure**
+
+                Filter expressions use a prefix notation where operators appear before their operands:
+                ```
+                [operator, operand1, operand2, ...]
+                ```
+
+                **Comparison Operators**
+                - `"equals"`: Exact match (equals)
+                - `"notequals"`: Not equal to value (not equals)
+                - `"greaterthan"`: Value is greater than specified value (is greater than)
+                - `"greaterthanequals"`: Value is greater than or equal to specified value (is greater than or equals)
+                - `"lessthan"`: Value is less than specified value (is less than)
+                - `"lessthanequals"`: Value is less than or equal to specified value (is less than or equals)
+                - `"startswith"`: String starts with specified prefix (starts with)
+                - `"endswith"`: String ends with specified suffix (ends with)
+                - `"contains"`: String contains specified substring (contains)
+                - `"doesnotcontain"`: String does not contain specified substring (does not contain)
+                - `"isempty"`: Field is empty or null (is empty)
+                - `"isnotempty"`: Field contains a value (is not empty)
+                - `"matches"`: Matches specified pattern (matches)
+
+                **Logical Operators**
+                - `"and"`: All conditions must be true
+                - `"or"`: At least one condition must be true
+                - `"not"`: Negates the condition
+
+                **Field Access and Type Conversion**
+                - `"extract"`: Access a field from the item by name
+                - `"settings"`: Access a custom setting from the flow, flow step, or integration configuration
+                - `"boolean"`: Convert value to Boolean type
+                - `"epochtime"`: Convert value to Epoch Time (Unix timestamp)
+                - `"number"`: Convert value to Number type
+                - `"string"`: Convert value to String type
+
+                **Field Access Details**
+
+                **Using `extract` to access record fields:**
+                - Retrieves values from the current record being processed
+                - Can access nested properties using dot notation (e.g., `"customer.email"`)
+                - Returns the raw field value which may need type conversion
+
+                **Using `settings` to access configuration values:**
+                - Retrieves values from the integration's configuration settings
+                - Supports different scopes with prefix notation:
+                  - `flow.settingName`: Access flow-level settings
+                  - `export.settingName`: Access export-level settings
+                  - `import.settingName`: Access import-level settings
+                  - `integration.settingName`: Access integration-level settings
+                - Useful for dynamic filtering based on configuration
+
+                **Field Transformations**
+                - `"lowercase"`: Convert string to lowercase
+                - `"uppercase"`: Convert string to uppercase
+                - `"ceiling"`: Round number up to the nearest integer
+                - `"floor"`: Round number down to the nearest integer
+                - `"abs"`: Get absolute value of a number
+
+                Type conversion operators are often necessary when comparing extracted field values against literals or when the field type doesn't match the comparison operator's expected type. For example:
+
+                ```json
+                [
+                  "equals",
+                  [
+                    "number",  // Convert to number before comparison
+                    [
+                      "extract",
+                      "quantity"
+                    ]
+                  ],
+                  100
+                ]
+                ```
+
+                Example with datetime conversion:
+                ```json
+                [
+                  "greaterthan",
+                  [
+                    "epochtime",  // Convert to Unix timestamp before comparison
+                    [
+                      "extract",
+                      "createdDate"
+                    ]
+                  ],
+                  1609459200000  // January 1, 2021 as Unix timestamp in milliseconds
+                ]
+                ```
+
+                Example with transformations:
+                ```json
+                [
+                  "and",
+                  [
+                    "matches",
+                    [
+                      "lowercase",  // Convert to lowercase before matching
+                      [
+                        "string",
+                        [
+                          "extract",
+                          "categories"
+                        ]
+                      ]
+                    ],
+                    "netsuite"
+                  ],
+                  [
+                    "notequals",
+                    [
+                      "string",
+                      [
+                        "extract",
+                        "recurrence.pattern.type"
+                      ]
+                    ],
+                    ""
+                  ]
+                ]
+                ```
+
+                Example comparing a record field with a flow setting:
+                ```json
+                [
+                  "equals",
+                  [
+                    "string",
+                    [
+                      "extract",
+                      "trantype"
+                    ]
+                  ],
+                  [
+                    "string",
+                    [
+                      "settings",
+                      "flow.trantype"
+                    ]
+                  ]
+                ]
+                ```
+
+                **Examples**
+
+                Example 1: Status field is not equal to "cancelled"
+                ```json
+                [
+                  "notequals",
+                  [
+                    "extract",
+                    "status"
+                  ],
+                  "cancelled"
+                ]
+                ```
+
+                Example 2: Filename starts with "HC"
+                ```json
+                [
+                  "startswith",
+                  [
+                    "extract",
+                    "filename"
+                  ],
+                  "HC"
+                ]
+                ```
+
+                Example 3: Amount is greater than 100
+                ```json
+                [
+                  "greaterthan",
+                  [
+                    "number",
+                    [
+                      "extract",
+                      "amount"
+                    ]
+                  ],
+                  100
+                ]
+                ```
+
+                Example 4: Order date is after January 1, 2023
+                ```json
+                [
+                  "greaterthan",
+                  [
+                    "extract",
+                    "orderDate"
+                  ],
+                  "2023-01-01T00:00:00Z"
+                ]
+                ```
+
+                Example 5: Category contains any of ["Urgent", "High Priority"]
+                ```json
+                [
+                  "anyof",
+                  [
+                    "extract",
+                    "category"
+                  ],
+                  ["Urgent", "High Priority"]
+                ]
+                ```
+              items:
+                oneOf:
+                  - title: String
+                    type: string
+                  - title: Number
+                    type: number
+                  - title: Boolean
+                    type: boolean
+                  - title: Object
+                    type: object
+                  - title: Array
+                    type: array
+                  - title: 'Null'
+                    type: 'null'
+        script:
+          type: object
+          description: |
+            Configuration for programmable script-based filtering. This object enables complex, custom
+            filtering logic beyond what expression-based filtering can provide.
+
+            **Usage context**
+
+            This object is REQUIRED when `filter.type` is set to "script" and should not be configured
+            otherwise. It provides a way to execute custom JavaScript code to determine which items
+            should be processed.
+
+            **Implementation approach**
+
+            Script-based filtering works by:
+            1. Executing the specified function from the referenced script
+            2. Passing item data to the function
+            3. Using the function's return value (true/false) to determine inclusion
+
+            **Common use cases**
+
+            Script filtering is ideal for:
+            - Complex business logic that can't be expressed as simple rules
+            - Dynamic filtering criteria that change based on external factors
+            - Content-based filtering that requires deep inspection
+            - Advanced pattern matching beyond simple wildcards
+            - Multi-stage filtering with intermediate logic
+
+            For AI agents: Only use script-based filtering when expression-based filtering is insufficient.
+            Script filtering requires maintaining custom code, which adds complexity to the integration.
+          properties:
+            _scriptId:
+              type: string
+              x-celigo-refModel: scripts
+              description: |
+                Reference to the Script resource that contains the filtering logic. This must be a valid
+                ObjectId of a Script resource that exists in the system.
+
+                The referenced script must contain the function specified in the `function` field
+                and must be written to handle filtering specifically. The script receives
+                item data as its input and must return a boolean value indicating whether
+                to process the item (true) or skip it (false).
+
+                Format: 24-character hexadecimal string (MongoDB ObjectId)
+              examples:
+                - 60a2c4e6f321d800129a1a3c
+                - 5f8d43a1b9e5a80011a35f2c
+            function:
+              type: string
+              description: |
+                Name of the function within the script to execute for filtering decisions. This function
+                must exist in the script referenced by _scriptId.
+
+                **Function requirements**
+
+                The specified function must:
+                - Accept item data as its first parameter
+                - Return a boolean value (true to process the item, false to skip it)
+                - Handle errors gracefully
+                - Execute efficiently (as it may run for many items)
+
+                **Function signature**
+
+                ```javascript
+                function filterItems(itemData) {
+                  // itemData contains properties of the item being evaluated
+                  // Custom logic here
+                  return true; // or false to skip the item
+                }
+                ```
+
+                For AI agents: Ensure the function name exactly matches a function defined in the
+                referenced script, as mismatches will cause the filter to fail.
+              examples:
+                - filterItems
+                - shouldProcess
+                - evaluateMatch
+    SupportedBySection:
+      type: object
+      description: |-
+        Conditions, pre-configured field values, and fields the user must set
+        for one resource type (connection, export, import, or iClient) when it
+        is created from this connector. All four sections share this shape.
+      properties:
+        preConfiguredFields:
+          type: array
+          description: Fields automatically set on the target resource. Not editable by the user.
+          items:
+            $ref: '#/components/schemas/SupportedByPreConfiguredField'
+        fieldsUserMustSet:
+          type: array
+          description: Fields the user must provide values for when creating the target resource.
+          items:
+            $ref: '#/components/schemas/SupportedByFieldUserMustSet'
+        fieldsToUnset:
+          type: array
+          description: Field paths to clear on the target resource.
+        conditions:
+          type: array
+          description: |-
+            Expression-based filters referenced by `_conditionIds` in
+            `preConfiguredFields` and `fieldsUserMustSet` to conditionally
+            apply those field configurations.
+          items:
+            type: object
+            properties:
+              _id:
+                type: string
+                format: objectId
+                readOnly: true
+                description: Unique identifier for this condition, referenced by `_conditionIds` in field entries.
+                examples:
+                  - 5f8d43a1b9e5a80011a35f2c
+              condition:
+                $ref: '#/components/schemas/Filter'
+    SupportedBy:
+      type: object
+      description: |-
+        Framework-defined defaults that pre-configure fields and prompt users
+        when a connection, export, import, or iClient is created from this
+        connector (or from a specific version / API group).
+      properties:
+        connection:
+          $ref: '#/components/schemas/SupportedBySection'
+        export:
+          $ref: '#/components/schemas/SupportedBySection'
+        import:
+          $ref: '#/components/schemas/SupportedBySection'
+        iClient:
+          $ref: '#/components/schemas/SupportedBySection'
+    Version:
+      type: object
+      description: |-
+        A version of the connector (or of an API group). Both contexts use the
+        same shape.
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          description: Unique identifier for this version.
+          examples:
+            - 63987132784a39b73aae63ce
+        name:
+          type: string
+          description: Display name for this version (e.g. `v3`).
+          examples:
+            - v3
+        published:
+          type: boolean
+          description: When true, this version is visible to users.
+        baseURIs:
+          type: array
+          description: Base URI templates used for requests targeting this version.
+          items:
+            type: string
+            examples:
+              - https://api.acme.com/v3
+        supportedBy:
+          $ref: '#/components/schemas/SupportedBy'
+    HTTPConnectorBase:
+      type: object
+      description: Writable fields shared by the request and response schemas.
+      properties:
+        name:
+          type: string
+          description: Display name for this HTTP Connector.
+          maxLength: 255
+          examples:
+            - Acme API
+        published:
+          type: boolean
+          description: When true, this connector is visible to users.
+        baseURIs:
+          type: array
+          description: Base URI templates (used when `apis` is empty).
+          items:
+            type: string
+            examples:
+              - https://api.acme.com
+        helpURL:
+          type: string
+          description: Documentation URL shown to users when configuring this connector.
+          examples:
+            - https://docs.celigo.com/hc/en-us/articles/4411468706203
+        legacyId:
+          type: string
+          description: Legacy assistant ID for backward compatibility.
+          examples:
+            - acme
+        isGraphQL:
+          type: boolean
+          description: When true, this connector targets a GraphQL API.
+        requireBodyMatchForLinking:
+          type: boolean
+          description: Require request body matching when auto-linking exports/imports.
+        disableAutoLinking:
+          type: boolean
+          description: Disable automatic linking of exports/imports to this connector.
+        versioning:
+          $ref: '#/components/schemas/Versioning'
+        versions:
+          type: array
+          description: Connector versions (used when `apis` is empty).
+          items:
+            $ref: '#/components/schemas/Version'
+        apis:
+          type: array
+          description: API groups under this connector. Each group has its own versions, baseURIs, and supportedBy config.
+          items:
+            type: object
+            properties:
+              _id:
+                type: string
+                format: objectId
+                readOnly: true
+                description: Unique identifier for this API group.
+                examples:
+                  - 6a1b2c3d4e5f6789abcdef02
+              name:
+                type: string
+                description: Display name for this API group.
+                examples:
+                  - Profit
+              description:
+                type: string
+                maxLength: 10240
+                description: Explains what this API group covers, shown to users when selecting an API.
+                examples:
+                  - Financial and ERP operations exposed by the Profit API.
+              published:
+                type: boolean
+                description: When true, this API group is visible to users.
+              baseURIs:
+                type: array
+                description: Base URI templates used for requests targeting this API group.
+                items:
+                  type: string
+                  examples:
+                    - https://api.acme.com/profit
+              helpURL:
+                type: string
+                description: Documentation URL shown to users when configuring this API group.
+                examples:
+                  - https://docs.celigo.com/hc/en-us/articles/42612451102235
+              legacyId:
+                type: string
+                description: Legacy assistant ID for backward compatibility.
+                examples:
+                  - acme-profit
+              isGraphQL:
+                type: boolean
+                description: When true, this API group targets a GraphQL API.
+              versioning:
+                $ref: '#/components/schemas/Versioning'
+              versions:
+                type: array
+                description: Versions available under this API group.
+                items:
+                  $ref: '#/components/schemas/Version'
+              supportedBy:
+                $ref: '#/components/schemas/SupportedBy'
+              setDefault:
+                type: boolean
+                description: When true, this API group is the connector's default selection.
+        supportedBy:
+          allOf:
+            - $ref: '#/components/schemas/SupportedBy'
+        preBuiltExports:
+          type: array
+          description: Pre-built export templates associated with this connector.
+          items:
+            type: object
+            properties:
+              _exportId:
+                type: string
+                format: objectId
+                x-celigo-refModel: exports
+                description: Export resource that serves as the pre-built template.
+                examples:
+                  - 66a1f2c3b4d5e6f7a8b9c0d1
+              published:
+                type: boolean
+                description: When true, this pre-built export is visible to users.
+            required:
+              - _exportId
+        preBuiltImports:
+          type: array
+          description: Pre-built import templates associated with this connector.
+          items:
+            type: object
+            properties:
+              _importId:
+                type: string
+                format: objectId
+                x-celigo-refModel: imports
+                description: Import resource that serves as the pre-built template.
+                examples:
+                  - 66b2e3d4c5f6a7b8c9d0e1f2
+              published:
+                type: boolean
+                description: When true, this pre-built import is visible to users.
+            required:
+              - _importId
+    Request:
+      type: object
+      description: |-
+        Fields for creating or updating an HTTP Connector. `name` is always
+        required. On create, provide either `versions` (flat connector) or
+        `apis` (grouped connector) -- most connectors use the flat pattern.
+      required:
+        - name
+      allOf:
+        - $ref: '#/components/schemas/HTTPConnectorBase'
+    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
+    HTTPConnector:
+      type: object
+      required:
+        - _id
+        - _userId
+        - name
+        - createdAt
+        - lastModified
+      description: HTTP Connector object as returned by the detail (by-ID) endpoint.
+      allOf:
+        - $ref: '#/components/schemas/HTTPConnectorBase'
+        - $ref: '#/components/schemas/ResourceResponse'
+        - type: object
+          properties:
+            _userId:
+              type: string
+              format: objectId
+              description: User who created this connector.
+              readOnly: true
+              x-celigo-refModel: users
+              examples:
+                - 6316f2b1e37e79778a43391c
+            legacyIds:
+              type: array
+              description: All legacy assistant IDs associated with this connector.
+              readOnly: true
+              items:
+                type: string
+                examples:
+                  - acme
+            supportsIClient:
+              type: boolean
+              description: When true, this connector supports shared iClient credentials.
+              readOnly: true
+            supportsWebhook:
+              type: boolean
+              description: When true, this connector supports webhook-based exports.
+              readOnly: true
+            hasBlobEndpoints:
+              type: boolean
+              description: When true, at least one endpoint under this connector handles binary/blob data.
+              readOnly: true
+            metadataLoadStrategy:
+              type: string
+              enum:
+                - staged
+              readOnly: true
+              x-enumDescriptions:
+                staged: Form metadata is loaded via catalog and resourceEndpointDetail routes
+              description: |-
+                Present only when the connector uses staged metadata loading. Omitted
+                when the stored strategy is `full`.
+            __numOfBlobEndpoints:
+              type: number
+              description: Number of blob endpoints for this connector
+              readOnly: true
+              examples:
+                - 2
+            metadata:
+              type: object
+              readOnly: true
+              description: |-
+                Connector metadata used by Data Intelligence tooling. Returned
+                only by the detail (by-ID) endpoint — list responses omit it.
+              properties:
+                di:
+                  type: object
+                  description: Data Intelligence attributes for this connector.
+                  properties:
+                    isSourceOnboard:
+                      type: boolean
+                      description: When true, the connector is onboarded as a Data Intelligence source.
+                    apiResolution:
+                      type: object
+                      description: |-
+                        Which API group and version Data Intelligence resolves this
+                        connector to. Present only on connectors with multiple API
+                        groups or versions.
+                      properties:
+                        api:
+                          type: string
+                          description: Name of the resolved API group.
+                          examples:
+                            - Profit
+                        version:
+                          type: string
+                          description: Name of the resolved version.
+                          examples:
+                            - v3
+    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
+    CatalogEndpointSummary:
+      type: object
+      required:
+        - id
+        - name
+      description: Projected endpoint summary in a form metadata catalog response.
+      properties:
+        id:
+          type: string
+          format: objectId
+          description: HTTP Connector Endpoint ID.
+          examples:
+            - 63987132784a39b73aae63f1
+        name:
+          type: string
+          description: Display name for this endpoint.
+          examples:
+            - Create order
+        ignoreExisting:
+          type: boolean
+          description: When true, import flows ignore records that already exist. Present for import catalogs only.
+        ignoreMissing:
+          type: boolean
+          description: When true, import flows ignore missing records. Present for import catalogs only.
+        isIdentifierPresent:
+          type: boolean
+          description: When true, the import endpoint exposes an identifier field. Present for import catalogs only.
+    CatalogResourceSummary:
+      type: object
+      required:
+        - id
+        - name
+        - endpoints
+      description: Projected resource summary in a form metadata catalog response.
+      properties:
+        id:
+          type: string
+          format: objectId
+          description: HTTP Connector Resource ID.
+          examples:
+            - 63987132784a39b73aae63e7
+        name:
+          type: string
+          description: Display name for this resource.
+          examples:
+            - Orders
+        _httpConnectorApiId:
+          type: string
+          format: objectId
+          x-celigo-refModel: httpconnectorapis
+          description: API group this resource belongs to when the connector uses grouped APIs.
+          examples:
+            - 6a1b2c3d4e5f6789abcdef02
+        _versionIds:
+          type: array
+          description: Version IDs this resource is associated with.
+          items:
+            type: string
+            format: objectId
+        versions:
+          type: array
+          description: Version labels associated with this resource.
+          items:
+            type: object
+            properties:
+              version:
+                type: string
+                description: Display name for the version.
+                examples:
+                  - v1
+              _id:
+                type: string
+                format: objectId
+                description: Version ID.
+                examples:
+                  - 63987132784a39b73aae63ce
+        endpoints:
+          type: array
+          description: Endpoint summaries available on this resource for the requested plane.
+          items:
+            $ref: '#/components/schemas/CatalogEndpointSummary'
+    HTTPConnectorCatalogResponse:
+      type: object
+      required:
+        - resources
+      description: Form metadata catalog for one import or export plane.
+      properties:
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Display labels for catalog UI sections.
+        versions:
+          type: array
+          description: Connector versions included in the catalog projection.
+          items:
+            type: object
+            properties:
+              version:
+                type: string
+                description: Display name for the version.
+                examples:
+                  - v1
+              _id:
+                type: string
+                format: objectId
+                description: Version ID.
+                examples:
+                  - 63987132784a39b73aae63ce
+        resources:
+          type: array
+          description: Projected resources and their endpoints for the requested plane.
+          items:
+            $ref: '#/components/schemas/CatalogResourceSummary'
+    HTTPConnectorResourceSummary:
+      type: object
+      description: Sanitized HTTP Connector Resource document returned by resourceEndpointDetail.
+      additionalProperties: true
+    HTTPConnectorEndpointSummary:
+      type: object
+      description: Sanitized HTTP Connector Endpoint document returned by resourceEndpointDetail.
+      additionalProperties: true
+    ResourceEndpointDetail:
+      type: object
+      required:
+        - resolvedResourceId
+        - httpConnectorResource
+      description: |-
+        Scoped resource and endpoint metadata for the HTTP connector form.
+        Single-endpoint requests return `resolvedEndpointId` and
+        `httpConnectorEndpoint`. Import batch requests (`endpointIds`) return
+        `resolvedEndpointIds` and `httpConnectorEndpoints` instead.
+      properties:
+        resolvedResourceId:
+          type: string
+          format: objectId
+          description: Resource ID resolved for the request.
+          examples:
+            - 63987132784a39b73aae63e7
+        resolvedEndpointId:
+          type: string
+          format: objectId
+          description: Endpoint ID for single-endpoint requests. Present when `resolvedEndpointIds` is absent.
+          examples:
+            - 63987132784a39b73aae63f1
+        resolvedEndpointIds:
+          type: array
+          minItems: 2
+          maxItems: 2
+          description: Create/update endpoint ID pair for import batch requests. Present for batch responses.
+          items:
+            type: string
+            format: objectId
+        resolvedVersionId:
+          type: string
+          format: objectId
+          description: Echoed when a version scope filter was supplied on the request.
+          examples:
+            - 63987132784a39b73aae63ce
+        httpConnectorResource:
+          $ref: '#/components/schemas/HTTPConnectorResourceSummary'
+        httpConnectorEndpoint:
+          $ref: '#/components/schemas/HTTPConnectorEndpointSummary'
+          description: Endpoint document for single-endpoint requests. Present when `resolvedEndpointIds` is absent.
+        httpConnectorEndpoints:
+          type: array
+          minItems: 2
+          maxItems: 2
+          description: Create/update endpoint documents for import batch requests. Present for batch responses.
+          items:
+            $ref: '#/components/schemas/HTTPConnectorEndpointSummary'
+        lookupHttpConnectorEndpoint:
+          $ref: '#/components/schemas/HTTPConnectorEndpointSummary'
+          description: |-
+            Present for import single-endpoint requests when a lookup endpoint
+            resolves in scope.
+        lookupHttpConnectorEndpoints:
+          type: array
+          description: Lookup endpoints resolved for import batch requests.
+          items:
+            $ref: '#/components/schemas/HTTPConnectorEndpointSummary'
+      if:
+        required:
+          - resolvedEndpointIds
+      then:
+        required:
+          - resolvedEndpointIds
+          - httpConnectorEndpoints
+      else:
+        required:
+          - resolvedEndpointId
+          - httpConnectorEndpoint
+  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.
+    403-forbidden:
+      description: |
+        Forbidden. The authenticated caller does not have permission to perform this operation.
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/Error'
+          examples:
+            default:
+              value:
+                errors:
+                  - code: forbidden
+                    message: You do not have permission to access this resource.
+    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.
+x-enable-proxy: true
+x-internal: false