API Evangelist conversational phrasing for Avalara Addresses API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara Addresses API
  version: 1.0.0
extends: openapi/avalara-addresses-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/v2/addresses/resolve'].get
  update:
    x-apievangelist-phrasing:
      intent: Resolve an address with a GET request
      effect: read
      questions:
      - Can I resolve an address with a simple GET instead of posting a body?
      - What does resolutionQuality tell me about how well an address was located?
      instructions:
      - text: Resolve an address using the GET address-resolution call.
      - text: Get the coordinates and resolution quality for an address via query string.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/addresses/resolve'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate and standardize an address
      effect: read
      questions:
      - How do I check that a customer's shipping address is valid before calculating tax?
      - Can I get the latitude, longitude and tax jurisdictions for a street address?
      - Is there a way to return a validated address in mixed case instead of uppercase?
      instructions:
      - text: Validate the address {line1}, {city}, {region} {postalCode}.
        slots:
          line1: requestBody.line1
          city: requestBody.city
          region: requestBody.region
          postalCode: requestBody.postalCode
      - text: Resolve {line1} in {postalCode}, {country} to a standardized address.
        slots:
          line1: requestBody.line1
          postalCode: requestBody.postalCode
          country: requestBody.country
      method: generated
      generated: '2026-09-26'