CustomerOS · OpenAPI Overlay 1.0.0

API Evangelist enhancements for CustomerOS Email verification and IP intelligence

4 actions 4 updates update extends openapi/customeros-verify-openapi.yml

Published by CustomerOS Authored by the provider (searched).

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-provenancex-apievangelist-surfacex-apievangelist-host-checkx-apievangelist-operationid-gapx-apievangelist-note

Targets 4

$.info

$.servers[0]

$.paths

$.components.securitySchemes.ApiKeyAuth

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for CustomerOS Email verification and IP intelligence
  version: 1.0.0
extends: openapi/customeros-verify-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-provenance:
      harvested: '2026-08-13'
      method: searched
      source: https://github.com/customeros/customeros/blob/otter/packages/server/customer-os-api/docs/openapi_verify.yaml
      note: Saved verbatim. This overlay carries API Evangelist observations; the underlying document
        is unmodified.
    x-apievangelist-surface: Email verification and IP intelligence
- target: $.servers[0]
  update:
    x-apievangelist-host-check:
      host: api.customeros.ai
      resolves: false
      checked: '2026-08-13'
      note: dig against 1.1.1.1 and 8.8.8.8 returns NOERROR with an empty answer section (MX records only).
        No A or AAAA record exists, so this server URL is not reachable as published.
- target: $.paths
  update:
    x-apievangelist-operationid-gap:
      operations: 5
      with_operation_id: 0
      note: No operation in this document declares an operationId. Tooling and agent skills must address
        these operations by METHOD + path.
- target: $.components.securitySchemes.ApiKeyAuth
  update:
    x-apievangelist-note: Per-tenant API key. Access to each endpoint group is granted on request by the
      CustomerOS team; there is no self-serve key issuance documented.