API Evangelist conversational phrasing for Twilio SendGrid Marketing Campaigns Single Sends API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio SendGrid Marketing Campaigns Single Sends API
  version: 1.0.0
extends: openapi/sendgrid-single-sends-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/v3/marketing/singlesends'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Single Sends
      effect: read
      questions:
      - What Single Sends have I created so far?
      - Can I page through all my Single Sends to collect their IDs?
      instructions:
      - text: List all my Single Sends.
      - text: Show my Single Sends, {page_size} per page.
        slots:
          page_size: query.page_size
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Single Send
      effect: write
      questions:
      - How do I set up a new Single Send marketing email?
      - Can I choose the lists or segments a Single Send goes to when I create it?
      - Do I still need a template ID to create a Single Send?
      instructions:
      - text: Create a Single Send named {name}.
        slots:
          name: requestBody.name
      - text: Create Single Send {name} going to {send_to} at {send_at}.
        slots:
          name: requestBody.name
          send_to: requestBody.send_to
          send_at: requestBody.send_at
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete Single Sends
      effect: destructive
      questions:
      - Can I delete several Single Sends at once by ID?
      - Is deleting multiple Single Sends permanent?
      instructions:
      - text: Delete the Single Sends with IDs {ids}.
        slots:
          ids: query.ids
      - text: 'Bulk remove these Single Sends: {ids}.'
        slots:
          ids: query.ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Single Send by ID
      effect: read
      questions:
      - What are the full details of one Single Send?
      - Where can I see the settings of a specific Single Send?
      instructions:
      - text: Get Single Send {id}.
        slots:
          id: path.id
      - text: Show me the full details of Single Send {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Duplicate a Single Send
      effect: write
      questions:
      - Can I copy an existing Single Send instead of starting from scratch?
      - Is it possible to give a duplicated Single Send a new name?
      instructions:
      - text: Duplicate Single Send {id}.
        slots:
          id: path.id
      - text: Make a copy of Single Send {id} called {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Single Send
      effect: destructive
      questions:
      - How do I permanently delete one Single Send?
      - Is a deleted Single Send recoverable?
      instructions:
      - text: Delete Single Send {id}.
        slots:
          id: path.id
      - text: Permanently remove the Single Send with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a draft Single Send
      effect: write
      questions:
      - Can I edit a Single Send draft without sending it?
      - Which Single Send fields can I change, like categories or recipients?
      instructions:
      - text: Update Single Send {id} with the name {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: 'Edit Single Send {id}: name {name}, categories {categories}.'
        slots:
          id: path.id
          name: requestBody.name
          categories: requestBody.categories
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/{id}/schedule'].put
  update:
    x-apievangelist-phrasing:
      intent: Send or schedule a Single Send
      effect: write
      questions:
      - Can I send a Single Send right now instead of scheduling it?
      - How do I schedule a Single Send for a future date and time?
      instructions:
      - text: Schedule Single Send {id} to go out at {send_at}.
        slots:
          id: path.id
          send_at: requestBody.send_at
      - text: Send Single Send {id} now by setting send time to {send_at}.
        slots:
          id: path.id
          send_at: requestBody.send_at
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/{id}/schedule'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a Single Send's schedule
      effect: destructive
      questions:
      - Can I cancel a scheduled Single Send without deleting it?
      - What happens to the Single Send itself when I remove its schedule?
      instructions:
      - text: Cancel the scheduled delivery of Single Send {id}.
        slots:
          id: path.id
      - text: Unschedule Single Send {id} but keep the draft.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Single Send categories
      effect: read
      questions:
      - Which categories have I used on my Single Sends?
      - How many Single Send categories does the category list return?
      instructions:
      - text: List all categories used on my Single Sends.
      - text: Show the latest categories attached to Single Sends.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/v3/marketing/singlesends/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search Single Sends by name, status or category
      effect: read
      questions:
      - Can I find Single Sends that are still drafts or already scheduled?
      - Is there a way to search Single Sends by name or category?
      instructions:
      - text: Search my Single Sends for the name {name}.
        slots:
          name: requestBody.name
      - text: Find Single Sends with status {status} in categories {categories}.
        slots:
          status: requestBody.status
          categories: requestBody.categories
      method: generated
      generated: '2026-09-24'