API Evangelist conversational phrasing for Doordash Address API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Address API
  version: 1.0.0
extends: openapi/doordash-address-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['/drive/v2/address/auto_complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Autocomplete a partial address for Drive
      effect: read
      questions:
      - How do I suggest full addresses while a Drive user types a dropoff address?
      - Can Drive address autocomplete be biased toward a location and search radius?
      instructions:
      - text: Suggest full Drive addresses for {input_address}.
        slots:
          input_address: requestBody.input_address
      - text: Autocomplete {input_address} within {search_radius_meter} meters, returning at most {max_results}.
        slots:
          input_address: requestBody.input_address
          search_radius_meter: requestBody.search_radius_meter
          max_results: requestBody.max_results
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/addresses/autocomplete'].get
  update:
    x-apievangelist-phrasing:
      intent: Suggest storefront addresses for typed input
      effect: read
      questions:
      - What storefront address suggestions match what a shopper has typed so far?
      - Can storefront address suggestions be limited to one country code?
      instructions:
      - text: Get storefront address suggestions for {input} under integration {integration_id}.
        slots:
          input: query.input
          integration_id: query.integration_id
      - text: Suggest addresses in {country_code} matching {input} for integration {integration_id}.
        slots:
          country_code: query.country_code
          input: query.input
          integration_id: query.integration_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/addresses/details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get full details for a suggested address
      effect: read
      questions:
      - How do I get the full details of an address the shopper picked from the suggestions?
      - What details come back for an address place id?
      instructions:
      - text: Get details for address place {source_place_id} under integration {integration_id}.
        slots:
          source_place_id: query.source_place_id
          integration_id: query.integration_id
      - text: Expand place id {source_place_id} into a complete address.
        slots:
          source_place_id: query.source_place_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/addresses/reverse_geocode'].get
  update:
    x-apievangelist-phrasing:
      intent: Find addresses near a latitude and longitude
      effect: read
      questions:
      - Which addresses are closest to a point on the map?
      - Can I reverse geocode a latitude and longitude into a street address for my storefront?
      instructions:
      - text: Find addresses at latitude {lat}, longitude {lon} for integration {integration_id}.
        slots:
          lat: query.lat
          lon: query.lon
          integration_id: query.integration_id
      - text: Reverse geocode {lat},{lon} into nearby addresses.
        slots:
          lat: query.lat
          lon: query.lon
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/addresses/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Get or create an address from a full string
      effect: write
      questions:
      - How do I turn a full formatted address string into a saved address record?
      - Will an existing address be returned if the same formatted address was created before?
      instructions:
      - text: Get or create the address {formatted_address} for integration {integration_id} ({integration_type}).
        slots:
          formatted_address: requestBody.formatted_address
          integration_id: requestBody.integration_id
          integration_type: requestBody.integration_type
      - text: Save the address {formatted_address} in country {country_code}.
        slots:
          formatted_address: requestBody.formatted_address
          country_code: requestBody.country_code
      method: generated
      generated: '2026-09-26'