# 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 1099 Forms API
  version: 1.0.0
extends: openapi/avalara-1099-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: 5
- target: $.paths['/forms/1099'].get
  update:
    x-apievangelist-phrasing:
      intent: List 1099 information returns
      effect: read
      questions:
      - Which 1099 forms have I prepared for the 2025 tax year?
      - Can I see only my 1099-NEC forms that are still in draft status?
      - What 1099 information returns exist in my Avalara account right now?
      instructions:
      - text: List my 1099 forms for tax year {taxYear}.
        slots:
          taxYear: query.taxYear
      - text: Show 1099 forms of type {formType} with status {status}.
        slots:
          formType: query.formType
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/forms/1099'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a 1099 form for a payee
      effect: write
      questions:
      - Can I create a new 1099 form with a payee's payment amounts?
      - What details do I need to start a 1099 information return for a contractor?
      instructions:
      - text: Create a {formType} 1099 form for tax year {taxYear} under payer company {payerCompanyId}.
        slots:
          formType: requestBody.formType
          taxYear: requestBody.taxYear
          payerCompanyId: requestBody.payerCompanyId
      - text: Start a new 1099 for payee {payee} with federal withholding of {federalTaxWithheld}.
        slots:
          payee: requestBody.payee
          federalTaxWithheld: requestBody.federalTaxWithheld
      method: generated
      generated: '2026-09-26'
- target: $.paths['/forms/1099/{formId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single 1099 form
      effect: read
      questions:
      - Where can I see the payee and amounts on one specific 1099 form?
      - Can I pull up a 1099 form by its ID to check its status?
      instructions:
      - text: Show me 1099 form {formId}.
        slots:
          formId: path.formId
      - text: Fetch the details of 1099 form {formId} including amounts withheld.
        slots:
          formId: path.formId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/forms/1099/{formId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing 1099 form
      effect: write
      questions:
      - Can I correct the payment amounts on a 1099 form I already created?
      - Is it possible to change the payee on an existing 1099?
      instructions:
      - text: Update 1099 form {formId} with amounts {amounts}.
        slots:
          formId: path.formId
          amounts: requestBody.amounts
      - text: Change the state tax withheld on 1099 form {formId} to {stateTaxWithheld}.
        slots:
          formId: path.formId
          stateTaxWithheld: requestBody.stateTaxWithheld
      method: generated
      generated: '2026-09-26'
- target: $.paths['/forms/1099/{formId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a 1099 form
      effect: destructive
      questions:
      - Can I remove a 1099 form I created by mistake?
      - What happens if I delete a draft 1099 information return?
      instructions:
      - text: Delete 1099 form {formId}.
        slots:
          formId: path.formId
      - text: Remove the duplicate 1099 form {formId} from my account.
        slots:
          formId: path.formId
      method: generated
      generated: '2026-09-26'