# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elation Health Ancillary Companies API
  version: 1.0.0
extends: openapi/elation-health-ancillary-companies-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-02'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/ancillary_companies/'].get
  update:
    x-apievangelist-phrasing:
      intent: Search ancillary companies by order type (legacy)
      effect: read
      questions:
      - Can I find the sleep or cardiac labs I can send orders to on the older unversioned endpoint?
      - Does the legacy ancillary company search require an order type?
      instructions:
      - text: Find legacy ancillary companies of type {type}.
        slots:
          type: query.type
      - text: Search legacy {type} companies named {name} on the unversioned endpoint.
        slots:
          type: query.type
          name: query.name
      method: generated
      generated: '2026-10-02'
- target: $.paths['/ancillary_companies/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an ancillary company (legacy)
      effect: read
      questions:
      - What does the legacy endpoint return for one ancillary company?
      - Can I read an outside service provider by id on the unversioned path?
      instructions:
      - text: Fetch legacy ancillary company {id}.
        slots:
          id: path.id
      - text: Open outside service provider {id} from the original route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/ancillary_companies/'].get
  update:
    x-apievangelist-phrasing:
      intent: List ancillary companies for an order type
      effect: read
      questions:
      - How do I list, in the v2.0 API, the companies that can fulfil a given type of order?
      - Can I filter v2.0 ancillary companies by name and page them?
      instructions:
      - text: List v2.0 ancillary companies for order type {type}.
        slots:
          type: query.type
      - text: Show {type} companies matching {name}, ordered by {order_by}.
        slots:
          type: query.type
          name: query.name
          order_by: query.order_by
      method: generated
      generated: '2026-10-02'
- target: $.paths['/api/2.0/ancillary_companies/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one ancillary company
      effect: read
      questions:
      - What details are stored for a single v2.0 ancillary company?
      - Which order type does a specific ancillary company serve?
      instructions:
      - text: Retrieve v2.0 ancillary company {id}.
        slots:
          id: path.id
      - text: Show the order type and locations of ancillary company {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'