API Evangelist conversational phrasing for Doordash Business & Store 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 Business & Store API
  version: 1.0.0
extends: openapi/doordash-business-store-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: 13
- target: $.paths['/developer/v1/businesses/{external_business_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Drive business's details
      effect: read
      questions:
      - What details are on file for a business I set up in Drive?
      - Is my Drive business currently active or inactive?
      instructions:
      - text: Get Drive business {external_business_id}.
        slots:
          external_business_id: path.external_business_id
      - text: Show the name and activation status of business {external_business_id}.
        slots:
          external_business_id: path.external_business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses/{external_business_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Drive business
      effect: write
      questions:
      - How do I rename a Drive business?
      - Can I deactivate a business I created earlier?
      instructions:
      - text: Rename business {external_business_id} to {name}.
        slots:
          external_business_id: path.external_business_id
          name: requestBody.name
      - text: Set business {external_business_id} activation status to {activation_status}.
        slots:
          external_business_id: path.external_business_id
          activation_status: requestBody.activation_status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Drive businesses
      effect: read
      questions:
      - Which businesses does my developer account own?
      - Can I list only the active businesses?
      instructions:
      - text: List all my Drive businesses.
      - text: List businesses with activation status {activationStatus}.
        slots:
          activationStatus: query.activationStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Drive business
      effect: write
      questions:
      - How do I create a new business in Drive?
      - Why can't I use 'default' as an external business id?
      instructions:
      - text: Create a Drive business {external_business_id} named {name}.
        slots:
          external_business_id: requestBody.external_business_id
          name: requestBody.name
      - text: Create business {external_business_id} called {name} with description {description}.
        slots:
          external_business_id: requestBody.external_business_id
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses/{external_business_id}/stores/{external_store_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Drive store's details
      effect: read
      questions:
      - What address and phone number are on file for one of my Drive stores?
      - Can I look up a single store by its external store id?
      instructions:
      - text: Get store {external_store_id} under business {external_business_id}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
      - text: Show the phone number and address of Drive store {external_store_id} in business {external_business_id}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses/{external_business_id}/stores/{external_store_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Drive store's name, phone or address
      effect: write
      questions:
      - How do I change a Drive store's phone number?
      - Can I update the pickup address of an existing Drive store?
      instructions:
      - text: Change the phone number of store {external_store_id} in business {external_business_id} to {phone_number}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
          phone_number: requestBody.phone_number
      - text: Move store {external_store_id} of business {external_business_id} to {address}.
        slots:
          external_store_id: path.external_store_id
          external_business_id: path.external_business_id
          address: requestBody.address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses/{external_business_id}/stores'].get
  update:
    x-apievangelist-phrasing:
      intent: List the Drive stores under a business
      effect: read
      questions:
      - Which Drive stores belong to a given business?
      - Can I list only the inactive stores for a business?
      instructions:
      - text: List stores under business {external_business_id}.
        slots:
          external_business_id: path.external_business_id
      - text: List {activationStatus} stores for business {external_business_id}.
        slots:
          activationStatus: query.activationStatus
          external_business_id: path.external_business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/developer/v1/businesses/{external_business_id}/stores'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Drive store under a business
      effect: write
      questions:
      - How do I add a new pickup store to a Drive business?
      - Where do stores go if I have not set up my own business yet?
      instructions:
      - text: Create store {external_store_id} named {name} at {address} under business {external_business_id}.
        slots:
          external_store_id: requestBody.external_store_id
          name: requestBody.name
          address: requestBody.address
          external_business_id: path.external_business_id
      - text: Add store {external_store_id} called {name} at {address} to my default business {external_business_id}.
        slots:
          external_store_id: requestBody.external_store_id
          name: requestBody.name
          address: requestBody.address
          external_business_id: path.external_business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/businesses/{business_id}/stores'].get
  update:
    x-apievangelist-phrasing:
      intent: List active storefront stores for a business
      effect: read
      questions:
      - Which of a business's stores are live on storefront right now?
      - Can I page through storefront stores by business with a limit?
      instructions:
      - text: List active storefront stores for business {business_id}.
        slots:
          business_id: path.business_id
      - text: List {limit} storefront stores for business {business_id} with store details.
        slots:
          limit: query.limit
          business_id: path.business_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/business_groups/{business_group_id}/stores'].get
  update:
    x-apievangelist-phrasing:
      intent: List active storefront stores for a business group
      effect: read
      questions:
      - What storefront stores are active across a business group?
      - Can store details be included when listing a business group's stores?
      instructions:
      - text: Show which stores in group {business_group_id} are live on storefront.
        slots:
          business_group_id: path.business_group_id
      - text: Page through business group {business_group_id} stores from token {pagination_token}.
        slots:
          business_group_id: path.business_group_id
          pagination_token: query.pagination_token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/stores/{store_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get storefront store details by store ID
      effect: read
      questions:
      - How do I get more details about a single storefront store?
      - Which details come back for one storefront store by its id?
      instructions:
      - text: Get storefront details for store {store_id}.
        slots:
          store_id: path.store_id
      - text: Look up storefront store {store_id}.
        slots:
          store_id: path.store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/stores/{store_id}/menus'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storefront store's current menus
      effect: read
      questions:
      - What menus does a storefront store currently have?
      - Where can I read the menus for a store by its store id?
      instructions:
      - text: Get the menus for store {store_id}.
        slots:
          store_id: path.store_id
      - text: Show what is on the menus of storefront store {store_id}.
        slots:
          store_id: path.store_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/storefront/api/v1/stores/{store_id}/menus/all'].get
  update:
    x-apievangelist-phrasing:
      intent: Get all active menus for a storefront store
      effect: read
      questions:
      - Can I fetch every active menu for a store at once?
      - Which menus are active for a store across all dayparts?
      instructions:
      - text: Get all active menus for store {store_id}.
        slots:
          store_id: path.store_id
      - text: List every active menu of storefront store {store_id}.
        slots:
          store_id: path.store_id
      method: generated
      generated: '2026-09-26'