overlay: 1.0.0
info:
  title: API Evangelist enhancements for CustomerOS GraphQL HTTP envelope
  version: 1.0.0
extends: openapi/customeros-graphql-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-provenance:
      harvested: '2026-08-13'
      method: searched
      source: openapi/_original/customeros-openapi.yml
      note: Saved verbatim. This overlay carries API Evangelist observations; the underlying document
        is unmodified.
    x-apievangelist-surface: GraphQL HTTP envelope
- 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: $.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.