# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Stedi Healthcare Payers API
  version: 1.0.0
extends: openapi/stedi-payers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/payer/{stediId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a payer by Stedi payer ID
      effect: read
      questions:
      - What transactions does a specific payer support?
      - Can I look up one payer's details using its Stedi payer ID?
      instructions:
      - text: Show payer {stediId}.
        slots:
          stediId: path.stediId
      - text: Get the payer record for Stedi ID {stediId}.
        slots:
          stediId: path.stediId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/payers'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported payers
      effect: read
      questions:
      - Which insurance payers does Stedi support?
      - Can I page through the full payer network as JSON?
      instructions:
      - text: List all supported payers.
      - text: Show the next page of payers after token {pageToken}.
        slots:
          pageToken: query.pageToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/payers/csv'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the payer list as CSV
      effect: read
      questions:
      - Can I get the complete payer list as a CSV spreadsheet?
      - Is there a downloadable file of every supported payer?
      instructions:
      - text: Download the payer list as CSV.
      - text: Export every supported payer to a CSV file.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/payers/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search payers
      effect: read
      questions:
      - Which payers support real-time eligibility checks in Texas?
      - How do I find a payer's ID when I only know part of its name?
      - Can I find payers that accept dental claims?
      instructions:
      - text: Search payers for {query}.
        slots:
          query: query.query
      - text: Find payers named {query} that support eligibility checks {eligibilityCheck}.
        slots:
          query: query.query
          eligibilityCheck: query.eligibilityCheck
      - text: Search payers operating in {operatingStates}.
        slots:
          operatingStates: query.operatingStates
      method: generated
      generated: '2026-09-26'