API Evangelist conversational phrasing for DoorDash Ads Assets 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 Ads Assets API
  version: 1.0.0
extends: openapi/doordash-assets-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: 3
- target: $.paths['/ads/api/v1/assets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an ad asset and get its upload URL
      effect: write
      questions:
      - How do I get an upload URL for a new image I want to use in a DoorDash ad?
      - What dimensions do I have to declare when creating a new ad asset?
      - Can I name and type a creative asset before I upload the file?
      instructions:
      - text: Create a new ad asset named {name} of type {type} at {width} by {height} pixels and give me the upload URL.
        slots:
          name: requestBody.name
          type: requestBody.type
          width: requestBody.width
          height: requestBody.height
      - text: Start a new {type} asset called {name}, {width}px wide and {height}px tall, so I can upload the file.
        slots:
          type: requestBody.type
          name: requestBody.name
          width: requestBody.width
          height: requestBody.height
      method: generated
      generated: '2026-10-01'
- target: $.paths['/ads/api/v1/assets/{assetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an ad asset by its ID
      effect: read
      questions:
      - Where can I see the details of one ad asset I already created?
      - Can I check what an existing asset's name, type and size are from its ID?
      instructions:
      - text: Show me ad asset {assetId}.
        slots:
          assetId: path.assetId
      - text: Fetch the details of the asset with ID {assetId}.
        slots:
          assetId: path.assetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/ads/api/v1/assets/{assetId}/register'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an asset after its upload finishes
      effect: write
      questions:
      - What do I do once I've finished uploading the file for an ad asset?
      - How do I tell DoorDash Ads my asset upload is complete?
      instructions:
      - text: Register asset {assetId} now that its upload is complete.
        slots:
          assetId: path.assetId
      - text: Mark the upload for asset {assetId} as finished and register it.
        slots:
          assetId: path.assetId
      method: generated
      generated: '2026-10-01'