# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara 1099 & W-9 W-9 Forms API
  version: 1.0.0
extends: openapi/avalara-w-9-forms-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: 3
- target: $.paths['/w9/requests'].get
  update:
    x-apievangelist-phrasing:
      intent: List W-9 collection requests
      effect: read
      questions:
      - Which vendors haven't returned their W-9 yet?
      - Can I list W-9 requests by status?
      instructions:
      - text: List my W-9 requests.
      - text: Show W-9 requests with status {status}.
        slots:
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/w9/requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a W-9 from a payee
      effect: write
      questions:
      - How do I ask a contractor to fill out a W-9 electronically?
      - Can I set how many days a W-9 request stays open?
      instructions:
      - text: Send a W-9 request to {payeeName} at {payeeEmail}.
        slots:
          payeeName: requestBody.payeeName
          payeeEmail: requestBody.payeeEmail
      - text: Request a W-9 from {payeeName} ({payeeEmail}) expiring in {expirationDays} days with note {message}.
        slots:
          payeeName: requestBody.payeeName
          payeeEmail: requestBody.payeeEmail
          expirationDays: requestBody.expirationDays
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/w9/{w9Id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a completed W-9
      effect: read
      questions:
      - Can I view the taxpayer information on a completed W-9?
      - Where do I get a W-9 a payee has submitted?
      instructions:
      - text: Get completed W-9 {w9Id}.
        slots:
          w9Id: path.w9Id
      - text: Show the taxpayer details on W-9 {w9Id}.
        slots:
          w9Id: path.w9Id
      method: generated
      generated: '2026-09-26'