@celigo/api-specs 0.2.39 → 0.2.41

package/dist/httpconnectorendpoint.yml

@@ -23,26 +23,31 @@ tags:
       and supported-by rules that control how exports and imports are
       pre-configured when users select this endpoint.
 
-      Endpoints are classified by `supportedBy.type`:
-      - **export** — reads data from the target system.
-      - **import** — writes data to the target system.
+      Manage your own endpoints through `/v1/httpconnectorendpoints` (list,
+      create) and `/v1/httpconnectorendpoints/{_id}` (get, update, delete).
+      The nested `/v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/...`
+      routes are read-only views scoped to one resource that also reach
+      endpoints published by other partners; an endpoint read through either
+      route is the same object.
 
       ## HTTP connector endpoint schema
 
       {% openapi-schemas spec="httpconnectorendpoint" schemas="HTTPConnectorEndpoint" grouped="true" %}
 paths:
-  /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/httpconnectorendpoints:
+  /v1/httpconnectorendpoints:
     get:
       x-internal: false
-      operationId: listHttpConnectorEndpoints
+      operationId: listOwnHttpConnectorEndpoints
       tags:
         - HTTP Connector Endpoints
-      summary: List HTTP Connector Endpoints for a connector resource
+      summary: List your HTTP Connector Endpoints
       description: |-
-        Returns all endpoints defined under the given HTTP Connector Resource.
-        The list response is abridged — only `_id`, `name`, `createdAt`, and
-        `lastModified` are returned. Use the by-ID endpoint for the full object
-        including `method`, `relativeURI`, and `supportedBy`.
+        Returns the full HTTP Connector Endpoints owned by the account, across all
+        of its connectors and resources, sorted by name. This is the canonical
+        CRUD listing; to browse the endpoints of one resource — including
+        endpoints published by other partners — use the scoped
+        `GET /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/httpconnectorendpoints`,
+        which returns an abridged shape.
       parameters:
         - name: limit
           in: query
@@ -53,6 +58,391 @@ paths:
             examples:
               - 100
         - $ref: '#/components/parameters/After'
+      responses:
+        '200':
+          description: Array of the account's HTTP Connector Endpoints.
+          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/HTTPConnectorEndpoint'
+              examples:
+                one_endpoint:
+                  value:
+                    - _id: 6ab1f999d38090b49147cf00
+                      name: List items
+                      description: Returns the items of the account.
+                      createdAt: '2026-09-22T03:44:25.604Z'
+                      lastModified: '2026-09-22T03:44:25.662Z'
+                      published: false
+                      isBlob: false
+                      isMappingRequired: true
+                      mergePostBodyToPagingPostBody: false
+                      _httpConnectorResourceIds:
+                        - 6ab1f97fdda4c325517b57b9
+                      method: GET
+                      relativeURI: /items/{{{id}}}
+                      queryParameters:
+                        - name: status
+                          label: Status
+                          description: Filter by status
+                          required: false
+                          dataType: select
+                          values:
+                            - open
+                            - closed
+                      pathParameters:
+                        - name: id
+                          label: Item ID
+                          required: true
+                          dataType: input
+                      supportedBy:
+                        type: export
+                        preConfiguredFields:
+                          - path: http.response.resourcePath
+                            values:
+                              - data
+                        fieldsUserMustSet:
+                          - path: type
+                            values:
+                              - delta
+                              - test
+                        fieldsToUnset:
+                          - http.paging.method
+        '204':
+          description: The account owns no HTTP Connector Endpoints.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+    post:
+      x-internal: false
+      operationId: createHttpConnectorEndpoint
+      tags:
+        - HTTP Connector Endpoints
+      summary: Create an HTTP Connector Endpoint
+      description: |-
+        Creates an operation under one or more of your HTTP Connector Resources.
+        Create the resource first (`POST /v1/httpconnectorresources`) and list
+        its id in `_httpConnectorResourceIds`; `supportedBy.type` decides whether
+        users build exports or imports on the endpoint. `method` is uppercased on
+        save, so `get` is stored as `GET`.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              minimal:
+                summary: Export endpoint with the required fields only
+                value:
+                  name: List items
+                  method: GET
+                  relativeURI: /items
+                  _httpConnectorResourceIds:
+                    - 6ab1f97fdda4c325517b57b9
+                  supportedBy:
+                    type: export
+              import_with_lookup:
+                summary: Import endpoint that looks up the existing record first
+                value:
+                  name: Create or update item
+                  method: POST
+                  relativeURI: /items
+                  _httpConnectorResourceIds:
+                    - 6ab1f97fdda4c325517b57b9
+                  supportedBy:
+                    type: import
+                    pathParameterToIdentifyExisting: id
+                    lookupToIdentifyExisting:
+                      _httpConnectorEndpointId: 6ab1f999d38090b49147cf00
+                      extract: data.0.id
+      responses:
+        '201':
+          description: Created endpoint.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnectorEndpoint'
+              examples:
+                created:
+                  value:
+                    _id: 6ab1f999d38090b49147cf00
+                    name: List items
+                    createdAt: '2026-09-22T03:44:25.604Z'
+                    lastModified: '2026-09-22T03:44:25.662Z'
+                    published: false
+                    isBlob: false
+                    isMappingRequired: false
+                    mergePostBodyToPagingPostBody: false
+                    _httpConnectorResourceIds:
+                      - 6ab1f97fdda4c325517b57b9
+                    method: GET
+                    relativeURI: /items
+                    supportedBy:
+                      type: export
+        '400':
+          $ref: '#/components/responses/400-bad-request'
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '422':
+          description: |-
+            A required field is missing, `method` or `supportedBy.type` is
+            outside its enum, a referenced resource or lookup endpoint is not
+            yours, or Data Intelligence metadata was sent for an unpublished
+            endpoint. Several problems are reported together.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                missing_fields:
+                  summary: Body without _httpConnectorResourceIds and supportedBy
+                  value:
+                    errors:
+                      - field: _httpConnectorResourceIds
+                        code: missing_required_field
+                        message: 'Expected field: _httpConnectorResourceIds to be present.'
+                      - field: supportedBy.type
+                        code: missing_required_field
+                        message: Path `supportedBy.type` is required.
+                invalid_method:
+                  value:
+                    errors:
+                      - field: method
+                        code: enum
+                        message: '`FETCH` is not a valid enum value for path `method`.'
+                invalid_resource:
+                  value:
+                    errors:
+                      - field: _httpConnectorResourceId[0]
+                        code: invalid_ref
+                        message: ' is not a valid _httpConnectorResourceIds'
+                unpublished_di_metadata:
+                  value:
+                    errors:
+                      - field: metadata.di.isListEndpoint.published
+                        code: must_be_published
+                        message: 'Invalid metadata.di.isListEndpoint: must_be_published.'
+  /v1/httpconnectorendpoints/{_id}:
+    get:
+      x-internal: false
+      operationId: getOwnHttpConnectorEndpointById
+      tags:
+        - HTTP Connector Endpoints
+      summary: Get one of your HTTP Connector Endpoints
+      description: |-
+        Returns the full endpoint. The nested
+        `GET /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/{_id}`
+        returns the identical object and additionally reaches endpoints published
+        by other partners; this route is limited to endpoints the account owns.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectorendpoints
+            examples:
+              - 6ab1f999d38090b49147cf00
+          description: HTTP Connector Endpoint ID.
+      responses:
+        '200':
+          description: The endpoint.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnectorEndpoint'
+              examples:
+                detail:
+                  value:
+                    _id: 6ab1f999d38090b49147cf00
+                    name: List items
+                    description: Returns the items of the account.
+                    createdAt: '2026-09-22T03:44:25.604Z'
+                    lastModified: '2026-09-22T03:44:25.662Z'
+                    published: false
+                    isBlob: false
+                    isMappingRequired: true
+                    mergePostBodyToPagingPostBody: false
+                    _httpConnectorResourceIds:
+                      - 6ab1f97fdda4c325517b57b9
+                    method: GET
+                    relativeURI: /items/{{{id}}}
+                    pathParameters:
+                      - name: id
+                        label: Item ID
+                        required: true
+                        dataType: input
+                    supportedBy:
+                      type: export
+                      preConfiguredFields:
+                        - path: http.response.resourcePath
+                          values:
+                            - data
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '404':
+          description: No endpoint with this id is owned by the account.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                not_found:
+                  value:
+                    errors:
+                      - code: invalid_ref
+                        message: HttpConnectorEndpoint not found.
+    put:
+      x-internal: false
+      operationId: updateHttpConnectorEndpoint
+      tags:
+        - HTTP Connector Endpoints
+      summary: Update an HTTP Connector Endpoint
+      description: |-
+        Replaces the endpoint with the request body. Send the complete document —
+        `description`, `queryParameters`, `pathParameters`, `resourceFields`, and
+        the `supportedBy` details are cleared when left out and
+        `isMappingRequired` / `mergePostBodyToPagingPostBody` revert to `false`,
+        while `published` and `isBlob` keep their stored values when omitted. The
+        five create-time requireds are required on every PUT.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectorendpoints
+            examples:
+              - 6ab1f999d38090b49147cf00
+          description: HTTP Connector Endpoint ID.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Request'
+            examples:
+              switch_to_import:
+                summary: Turn the endpoint into an import operation
+                value:
+                  name: Create item
+                  method: POST
+                  relativeURI: /items
+                  _httpConnectorResourceIds:
+                    - 6ab1f97fdda4c325517b57b9
+                  supportedBy:
+                    type: import
+      responses:
+        '200':
+          description: Updated endpoint.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPConnectorEndpoint'
+              examples:
+                updated:
+                  value:
+                    _id: 6ab1f999d38090b49147cf00
+                    name: Create item
+                    createdAt: '2026-09-22T03:44:25.604Z'
+                    lastModified: '2026-09-22T03:41:33.711Z'
+                    published: false
+                    isBlob: false
+                    isMappingRequired: false
+                    mergePostBodyToPagingPostBody: false
+                    _httpConnectorResourceIds:
+                      - 6ab1f97fdda4c325517b57b9
+                    method: POST
+                    relativeURI: /items
+                    supportedBy:
+                      type: import
+        '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: deleteHttpConnectorEndpoint
+      tags:
+        - HTTP Connector Endpoints
+      summary: Delete an HTTP Connector Endpoint
+      description: |-
+        Deletes the endpoint. Refused while another endpoint still names it in
+        `supportedBy.lookupToIdentifyExisting._httpConnectorEndpointId` — update
+        or delete that endpoint first. Not recoverable through the recycle bin.
+      parameters:
+        - in: path
+          name: _id
+          required: true
+          schema:
+            type: string
+            format: objectId
+            x-celigo-refModel: httpconnectorendpoints
+            examples:
+              - 6ab1f999d38090b49147cf00
+          description: HTTP Connector Endpoint ID.
+      responses:
+        '204':
+          description: Endpoint deleted.
+        '401':
+          $ref: '#/components/responses/401-unauthorized'
+        '403':
+          $ref: '#/components/responses/403-forbidden'
+        '404':
+          $ref: '#/components/responses/404-not-found'
+        '422':
+          description: Another endpoint's lookup still references this endpoint.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                referenced:
+                  value:
+                    errors:
+                      - code: delete_not_allowed
+                        message: 'this document is referenced by HttpConnectorEndpoint : 6ab1f99944e1de3266eb80e2'
+  /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/httpconnectorendpoints:
+    get:
+      x-internal: false
+      operationId: listHttpConnectorEndpoints
+      tags:
+        - HTTP Connector Endpoints
+      summary: List a resource's HTTP Connector Endpoints
+      description: |-
+        Returns the endpoints defined under the given HTTP Connector Resource —
+        your own and, for resources published by other partners, their published
+        endpoints — sorted by name. The whole list is returned in one response.
+
+        The shape is abridged: only `_id`, `name`, `description`, `createdAt`,
+        and `lastModified` are returned. Use the by-ID endpoint for the full
+        object including `method`, `relativeURI`, and `supportedBy`, or
+        `GET /v1/httpconnectorendpoints` for the full shape of everything your
+        account owns.
+      parameters:
         - in: path
           name: _httpConnectorId
           required: true
@@ -69,6 +459,7 @@ paths:
           schema:
             type: string
             format: objectId
+            x-celigo-refModel: httpconnectorresources
             examples:
               - 63987132784a39b73aae63e7
           description: HTTP Connector Resource ID.
@@ -82,22 +473,18 @@ paths:
             x-enumDescriptions:
               import: Return only endpoints used as imports (write to target system).
               export: Return only endpoints used as exports (read from target system).
-          description: Filter endpoints by their supported-by direction.
+          description: Return only endpoints whose `supportedBy.type` matches.
         - in: query
           name: publishedOnly
           schema:
             type: boolean
-          description: When true, only return published endpoints.
+            default: false
+          description: |-
+            When true, returns only published endpoints. The connector must be
+            published as well, otherwise the request fails with 404.
       responses:
         '200':
-          description: Successfully retrieved list of HTTP Connector Endpoints.
-          headers:
-            Link:
-              description: |-
-                RFC-5988 pagination links. When more pages remain, includes a `<...>; rel="next"` entry;
-                absent on the final page.
-              schema:
-                type: string
+          description: Abridged endpoints of the resource.
           content:
             application/json:
               schema:
@@ -109,6 +496,7 @@ paths:
                   value:
                     - _id: 63987132784a39b73aae63e8
                       name: List
+                      description: Returns all answers for a question.
                       createdAt: '2023-01-17T09:52:06.871Z'
                       lastModified: '2024-05-23T07:00:46.308Z'
                     - _id: 63987132784a39b73aae63e9
@@ -120,7 +508,19 @@ paths:
         '401':
           $ref: '#/components/responses/401-unauthorized'
         '404':
-          $ref: '#/components/responses/404-not-found'
+          description: |-
+            The connector or resource does not exist, or is neither yours nor
+            published.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+              examples:
+                not_found:
+                  value:
+                    errors:
+                      - code: invalid_ref
+                        message: httpConnectorResource not found or not published.
   /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/{_id}:
     get:
       x-internal: false
@@ -131,7 +531,9 @@ paths:
       description: |-
         Retrieves the full HTTP Connector Endpoint including `method`,
         `relativeURI`, `queryParameters`, `pathParameters`, and `supportedBy`
-        details omitted from the list endpoint.
+        details omitted from the list endpoint — the same object
+        `GET /v1/httpconnectorendpoints/{_id}` returns, but this route also
+        reaches endpoints published by other partners.
       parameters:
         - in: path
           name: _httpConnectorId
@@ -149,6 +551,7 @@ paths:
           schema:
             type: string
             format: objectId
+            x-celigo-refModel: httpconnectorresources
             examples:
               - 63987132784a39b73aae63e7
           description: HTTP Connector Resource ID.
@@ -223,113 +626,47 @@ components:
       schema:
         type: string
   schemas:
-    ListItem:
-      type: object
-      description: |-
-        Abridged HTTP Connector Endpoint returned in list responses. Only
-        includes identity and timestamp fields. Use the by-ID endpoint for
-        the full object including method, relativeURI, and supportedBy.
-      properties:
-        _id:
-          type: string
-          format: objectId
-          readOnly: true
-          description: Unique identifier for the resource. Format is a 24-character hexadecimal string.
-          x-celigo-refModel: httpconnectorendpoints
-          examples:
-            - 63987132784a39b73aae63e8
-        name:
-          type: string
-          description: Human-readable name for this endpoint.
-          examples:
-            - List
-        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:52:06.871Z'
-        lastModified:
-          type: string
-          format: date-time
-          readOnly: true
-          description: Timestamp when the resource was last updated. Changes whenever any property is modified.
-          examples:
-            - '2024-05-23T07:00:46.308Z'
-    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
     HTTPConnectorEndpointBase:
       type: object
       description: Writable fields shared by the request and response schemas.
       properties:
         name:
           type: string
-          description: Human-readable name for this endpoint
+          description: Human-readable name for this endpoint, shown when users pick an operation.
           maxLength: 255
           examples:
             - List
         description:
           type: string
-          description: Optional endpoint description
+          description: Help text describing what the endpoint does. Absent when never set.
           maxLength: 10240
           examples:
             - Returns all answers for a question.
         published:
           type: boolean
-          description: When true, this endpoint is published and available for use.
+          default: false
+          description: |-
+            When true, this endpoint is visible in the connector's published
+            catalog. Kept as stored when omitted on PUT.
         isBlob:
           type: boolean
-          description: When true, this endpoint handles binary/blob data.
           default: false
+          description: When true, this endpoint transfers binary (blob) content instead of records. Kept as stored when omitted on PUT.
         isMappingRequired:
           type: boolean
-          description: When true, field mapping is required for this endpoint.
           default: false
+          description: When true, users must configure field mappings before an import built on this endpoint can run.
         _httpConnectorResourceIds:
           type: array
-          description: References to HTTP Connector Resources associated with this endpoint
+          minItems: 1
+          description: |-
+            HTTP Connector Resources this endpoint is listed under. Each id must
+            be a resource owned by the caller's account; the endpoint appears in
+            the nested listing of every resource named here.
           items:
             type: string
             format: objectId
+            x-celigo-refModel: httpconnectorresources
             examples:
               - 63987132784a39b73aae63e7
         method:
@@ -373,7 +710,7 @@ components:
                   - question_id
               label:
                 type: string
-                description: Label shown to users in the UI for this parameter.
+                description: Label shown to users in the UI for this parameter. Defaults to `name` when omitted.
                 examples:
                   - Question ID
               description:
@@ -393,6 +730,7 @@ components:
                   - multiselect
                   - array
                   - number
+                default: input
                 x-enumDescriptions:
                   input: Free-form text input field.
                   date: Date picker input field.
@@ -400,7 +738,7 @@ components:
                   multiselect: Multi-value dropdown selection.
                   array: Array of values.
                   number: Numeric input field.
-                description: UI input type used to collect the parameter value.
+                description: UI input type used to collect the parameter value. A free-form text input when omitted.
               values:
                 type: array
                 description: Predefined values offered when `dataType` is `select` or `multiselect`.
@@ -410,7 +748,6 @@ components:
                     - open
             required:
               - name
-              - label
         pathParameters:
           type: array
           description: Path parameter definitions
@@ -424,7 +761,7 @@ components:
                   - id
               label:
                 type: string
-                description: Label shown to users in the UI for this parameter.
+                description: Label shown to users in the UI for this parameter. Defaults to `name` when omitted.
                 examples:
                   - Answer ID
               description:
@@ -444,6 +781,7 @@ components:
                   - multiselect
                   - array
                   - number
+                default: input
                 x-enumDescriptions:
                   input: Free-form text input field.
                   date: Date picker input field.
@@ -451,7 +789,7 @@ components:
                   multiselect: Multi-value dropdown selection.
                   array: Array of values.
                   number: Numeric input field.
-                description: UI input type used to collect the parameter value.
+                description: UI input type used to collect the parameter value. A free-form text input when omitted.
               values:
                 type: array
                 description: Predefined values offered when `dataType` is `select` or `multiselect`.
@@ -461,7 +799,6 @@ components:
                     - open
             required:
               - name
-              - label
         resourceFields:
           type: array
           description: Resource field definitions for this endpoint
@@ -496,7 +833,12 @@ components:
               - _httpConnectorResourceId
         supportedBy:
           type: object
-          description: Supported-by configuration for this endpoint (framework-defined)
+          description: |-
+            How the connector framework turns this endpoint into an export or an
+            import: which one it becomes, the fields it pre-configures, and the
+            fields the user must still fill in.
+          required:
+            - type
           properties:
             type:
               type: string
@@ -506,7 +848,9 @@ components:
               x-enumDescriptions:
                 import: This endpoint is used as an import (writes data to the target system).
                 export: This endpoint is used as an export (reads data from the target system).
-              description: Whether this endpoint is consumed as an import or an export.
+              description: |-
+                Whether this endpoint is consumed as an import or an export. Also
+                the value the nested listing's `supportedByType` filter matches.
             conditions:
               type: array
               description: Expression-based filters that control when entries in `preConfiguredFields` and `fieldsUserMustSet` apply.
@@ -611,28 +955,29 @@ components:
         - method
         - relativeURI
         - published
+        - isBlob
+        - isMappingRequired
+        - mergePostBodyToPagingPostBody
+        - _httpConnectorResourceIds
         - createdAt
         - lastModified
-      description: HTTP Connector Endpoint object as returned by the detail (by-ID) endpoint.
+      description: |-
+        HTTP Connector Endpoint as returned by `GET /v1/httpconnectorendpoints`,
+        `GET /v1/httpconnectorendpoints/{_id}`, and the nested
+        `GET /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/{_id}`
+        — all three return the same object. Optional fields that were never set
+        are absent.
       allOf:
         - $ref: '#/components/schemas/HTTPConnectorEndpointBase'
         - $ref: '#/components/schemas/ResourceResponse'
         - type: object
           properties:
-            _userId:
-              type: string
-              format: objectId
-              description: Owner user id
-              readOnly: true
-              x-celigo-refModel: users
-              examples:
-                - 55f9d6e0c1a2b3d4e5f60718
             metadata:
               type: object
-              readOnly: true
               description: |-
-                Endpoint metadata used by Data Intelligence tooling. Returned
-                only by the detail (by-ID) endpoint — list responses omit it.
+                Endpoint metadata used by Data Intelligence tooling. Absent when
+                never set; Data Intelligence attributes can only be stored on a
+                published endpoint.
               properties:
                 di:
                   type: object
@@ -657,6 +1002,111 @@ components:
                             description: Data type of the field.
                             examples:
                               - string
+    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
+    Request:
+      type: object
+      description: |-
+        Fields for creating or updating an HTTP Connector Endpoint through
+        `POST /v1/httpconnectorendpoints` and `PUT /v1/httpconnectorendpoints/{_id}`.
+        PUT replaces the whole document — omitted optional fields are cleared
+        (`isMappingRequired` and `mergePostBodyToPagingPostBody` revert to
+        `false`), except `published` and `isBlob`, which keep their stored values.
+      required:
+        - name
+        - method
+        - relativeURI
+        - _httpConnectorResourceIds
+        - supportedBy
+      x-celigo-ai-guidance:
+        - Every create needs name, method, relativeURI, at least one id in _httpConnectorResourceIds, and supportedBy.type; each missing field is reported as its own 422 missing_required_field entry. A method outside the enum fails with 422 code "enum", and an id in _httpConnectorResourceIds that is not one of your resources fails with 422 invalid_ref.
+        - Setting metadata.di.isListEndpoint on an unpublished endpoint fails with 422 must_be_published; publish the endpoint (published true) in the same request or leave metadata out.
+      allOf:
+        - $ref: '#/components/schemas/HTTPConnectorEndpointBase'
+    ListItem:
+      type: object
+      description: |-
+        Abridged HTTP Connector Endpoint returned by the nested
+        `GET /v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/httpconnectorendpoints`
+        catalog listing. Includes identity, description, and timestamps only;
+        fetch the full object by id for `method`, `relativeURI`, and
+        `supportedBy`.
+      required:
+        - _id
+        - name
+        - createdAt
+        - lastModified
+      properties:
+        _id:
+          type: string
+          format: objectId
+          readOnly: true
+          description: Unique identifier for the endpoint.
+          x-celigo-refModel: httpconnectorendpoints
+          examples:
+            - 63987132784a39b73aae63e8
+        name:
+          type: string
+          description: Human-readable name for this endpoint.
+          examples:
+            - List
+        description:
+          type: string
+          description: Help text describing what the endpoint does. Absent when never set.
+          examples:
+            - Returns all answers for a question.
+        createdAt:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the endpoint was created.
+          examples:
+            - '2023-01-17T09:52:06.871Z'
+        lastModified:
+          type: string
+          format: date-time
+          readOnly: true
+          description: Timestamp when the endpoint was last updated. Changes on every PUT.
+          examples:
+            - '2024-05-23T07:00:46.308Z'
   responses:
     401-unauthorized:
       description: |-
@@ -692,6 +1142,32 @@ components:
               summary: Bearer token invalid or revoked
               value:
                 message: Bearer Authentication Failed
+    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.
+    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.
     404-not-found:
       description: |
         Not found. The requested resource does not exist or is not visible to the caller.
@@ -705,9 +1181,9 @@ components:
                 errors:
                   - code: not_found
                     message: The requested resource was not found.
-    403-forbidden:
+    422-unprocessable-entity:
       description: |
-        Forbidden. The authenticated caller does not have permission to perform this operation.
+        Unprocessable entity. The request was well-formed but was unable to be followed due to semantic errors.
       content:
         application/json:
           schema:
@@ -716,7 +1192,7 @@ components:
             default:
               value:
                 errors:
-                  - code: forbidden
-                    message: You do not have permission to access this resource.
+                  - code: unprocessable_entity
+                    message: The request could not be processed due to a semantic error.
 x-enable-proxy: true
 x-internal: false