overlay: 1.0.0
info:
  title: API Evangelist enhancements for AdvancedMD FHIR Single API (US Core 6.1.0)
  version: 1.0.0
extends: openapi/advancedmd-fhir-single-api-openapi.json
x-generated: '2026-07-27'
x-method: generated
x-source: Generated by the API Evangelist enrichment pipeline from the harvested spec plus the artifacts
  in this repo. The original document under openapi/ is never mutated.
x-contract-gaps:
- AdvancedMD publishes this spec without operationIds on the 41 read/search GET operations; only the 17
  POST _search and $docref operations carry one.
- The spec declares a single bearerAuth (http/bearer/JWT) scheme and does not model the SMART-on-FHIR
  OAuth 2.0 flows that actually issue that token.
- servers[] carries the org-less root https://providerapi.advancedmd.com/v1/r4; every real call must insert
  the organization id segment.
actions:
- target: $.info
  update:
    x-apievangelist-provider: advancedmd
    x-apievangelist-artifacts:
      authentication: authentication/advancedmd-authentication.yml
      scopes: scopes/advancedmd-scopes.yml
      conventions: conventions/advancedmd-conventions.yml
      errors: errors/advancedmd-problem-types.yml
      lifecycle: lifecycle/advancedmd-lifecycle.yml
      conformance: conformance/advancedmd-conformance.yml
      sandbox: sandbox/advancedmd-sandbox.yml
      rate_limits: rate-limits/advancedmd-rate-limits.yml
      data_model: data-model/advancedmd-data-model.yml
      agentic_access: agentic-access/advancedmd-agentic-access.yml
- target: $
  update:
    x-apievangelist-access:
      pricing: free
      onboarding: self-service registration on https://fhir.advancedmd.com plus email approval from InterOps@advancedmd.com
        before production access