# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Live Direct Marketing Online Providers API
  version: 1.0.0
extends: openapi/live-direct-marketing-online-providers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/api/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List providers (public, unversioned)
      effect: read
      questions:
      - Is there a public unversioned list of providers I can read without the v1 API?
      - Where's the plain providers listing endpoint?
      instructions:
      - text: List providers from the public unversioned endpoint.
      - text: Show the public providers list.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List deliverability providers my key can use
      effect: read
      questions:
      - Which deliverability providers can my API key use, and why are some unavailable?
      - Can I tell which providers need a plan upgrade?
      instructions:
      - text: List the v1 deliverability providers and which my key may use.
      - text: Show providers I can't use with this key and the reasons.
      method: generated
      generated: '2026-10-01'