Doordash · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Doordash Store Endpoints API

13 actions 13 updates phrasing extends openapi/doordash-store-endpoints-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Doordash's API. It is a proposal applied on top of the contract, not a document Doordash publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 13

$.info

$.paths['/api/v1/stores/{location_id}'].get

$.paths['/api/v1/stores/{location_id}/activation-status'].put

$.paths['/api/v1/stores/{merchant_supplied_id}/item/activation-status'].put

$.paths['/api/v1/stores/{merchant_supplied_id}/item_option/activation-status'].put

$.paths['/api/v1/stores/{merchant_supplied_id}/menu_details'].get

$.paths['/api/v1/stores/{merchant_supplied_id}/store_menu'].get

$.paths['/api/v1/stores/{location_id}/store_details'].get

$.paths['/api/v1/stores/{location_id}/status'].put

$.paths['/api/v1/stores/{merchant_supplied_id}/item/availability'].get

$.paths['/api/v1/stores/{merchant_supplied_id}/item_option/availability'].get

$.paths['/api/v1/stores/{merchant_supplied_id}/items/status'].put

$.paths['/api/v1/stores/{merchant_supplied_id}/item_options/status'].put

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Doordash Store Endpoints API
  version: 1.0.0
extends: openapi/doordash-store-endpoints-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: 12
- target: $.paths['/api/v1/stores/{location_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get store summary (base store path)
      effect: read
      questions:
      - What summary info is held for my store location on the base store endpoint?
      - Can I read a store's summary from the plain store location path?
      instructions:
      - text: Get the store summary for location {location_id} from the base store path.
        slots:
          location_id: path.location_id
      - text: Show summary info for store location {location_id} using the plain stores path.
        slots:
          location_id: path.location_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{location_id}/activation-status'].put
  update:
    x-apievangelist-phrasing:
      intent: Activate or deactivate a store (activation-status)
      effect: write
      questions:
      - How do I deactivate a store with a reason using the activation-status endpoint?
      - Can I reactivate a store through the activation-status endpoint?
      instructions:
      - text: Deactivate store {location_id} via activation-status with reason {reason}.
        slots:
          location_id: path.location_id
          reason: requestBody.reason
      - text: Set store {location_id} activation-status is_active to {is_active}.
        slots:
          location_id: path.location_id
          is_active: requestBody.is_active
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/item/activation-status'].put
  update:
    x-apievangelist-phrasing:
      intent: Stock items in or out (item activation-status)
      effect: write
      questions:
      - Can I mark items in or out of stock through the item activation-status webhook?
      - Which webhook path is item/activation-status for stocking items?
      instructions:
      - text: Update item activation-status for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Stock items in or out at store {merchant_supplied_id} using item/activation-status.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/item_option/activation-status'].put
  update:
    x-apievangelist-phrasing:
      intent: Stock item options in or out (activation-status)
      effect: write
      questions:
      - Can I stock item options in or out through the item_option activation-status webhook?
      - Can I use item_option/activation-status to mark options out of stock?
      instructions:
      - text: Update item_option activation-status for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Mark item options out of stock at store {merchant_supplied_id} with item_option/activation-status.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/menu_details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a store's menu details
      effect: read
      questions:
      - What menu details are held for my store?
      - Can I see summary menu details for a store location?
      instructions:
      - text: Get menu details for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Show the menu_details of store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/store_menu'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a store's raw menu JSON
      effect: read
      questions:
      - Can I pull the raw menu JSON for a store?
      - Where do I get the full store_menu JSON documents?
      instructions:
      - text: Get the menu JSONs for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Download the store_menu JSON for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{location_id}/store_details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get store summary (store_details path)
      effect: read
      questions:
      - Can I get my store's summary from the store_details endpoint?
      - Which summary fields does the store_details endpoint return for a location?
      instructions:
      - text: Get the store_details summary for location {location_id}.
        slots:
          location_id: path.location_id
      - text: Fetch store_details for store location {location_id}.
        slots:
          location_id: path.location_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{location_id}/status'].put
  update:
    x-apievangelist-phrasing:
      intent: Deactivate a store for a set duration
      effect: write
      questions:
      - Can I deactivate a store for a set number of hours?
      - How do I temporarily close a store until a specific end time?
      instructions:
      - text: Deactivate store {location_id} for {duration_in_hours} hours.
        slots:
          location_id: path.location_id
          duration_in_hours: requestBody.duration_in_hours
      - text: Set store {location_id} active to {is_active} until {end_time}.
        slots:
          location_id: path.location_id
          is_active: requestBody.is_active
          end_time: requestBody.end_time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/item/availability'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether an item is available
      effect: read
      questions:
      - Is a given item available right now?
      - Can I look up whether an item is in stock by its ID in my system?
      instructions:
      - text: Check availability of item {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Look up whether item {merchant_supplied_id} is in stock.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/item_option/availability'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether an item option is available
      effect: read
      questions:
      - Is a particular item option, like a topping, available right now?
      - Can I check an item option's stock by its option ID?
      instructions:
      - text: Get availability of item option {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Look up whether option {merchant_supplied_id} is in stock.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/items/status'].put
  update:
    x-apievangelist-phrasing:
      intent: Stock items in or out (items/status)
      effect: write
      questions:
      - Can I stock items in or out through the items/status webhook?
      - What is the items/status webhook for stocking items in and out?
      instructions:
      - text: Stock items in or out via items/status for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Mark items out of stock at store {merchant_supplied_id} using items/status.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stores/{merchant_supplied_id}/item_options/status'].put
  update:
    x-apievangelist-phrasing:
      intent: Stock item options in or out (item_options/status)
      effect: write
      questions:
      - How do I stock item options in or out through the item_options/status webhook?
      - Can I use item_options/status to bring options back in stock?
      instructions:
      - text: Toggle item option stock via item_options/status for store {merchant_supplied_id}.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      - text: Bring item options back in stock at store {merchant_supplied_id} with item_options/status.
        slots:
          merchant_supplied_id: path.merchant_supplied_id
      method: generated
      generated: '2026-09-26'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/doordash-store-endpoints-api-phrasing-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.