overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Tebra Clinical API
  version: 1.0.0
extends: openapi/tebra-clinical-api-openapi.yml
x-generated: '2026-08-14'
x-method: generated
x-source: live DNS probe of servers[] host, 2026-08-14
x-note: >-
  Records a lifecycle finding without mutating the harvested spec: the
  documented production host (api.tebra.com) fails DNS resolution (NXDOMAIN)
  on the system resolver and on 8.8.8.8/1.1.1.1 as of 2026-08-14, even though
  it is confirmed verbatim from Tebra's own Oct 2023 "General API
  Documentation" PDF. See lifecycle/tebra-lifecycle.yml and
  security/tebra-domain-security.yml.
actions:
- target: $.servers[0]
  description: Flag the documented host as currently unreachable rather than silently leaving the gap unrecorded.
  update:
    x-api-evangelist-dns-status: NXDOMAIN
    x-api-evangelist-probed: '2026-08-14'
    x-api-evangelist-note: >-
      Host does not resolve; consider Tebra's newer FHIR API
      (tebra:tebra-fhir-api, fhir.prd.cloud.tebra.com) as the current
      USCDI patient-access surface.