# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mapp Engage public Draft Message API
  version: 1.0.0
extends: openapi/mapp-draft-message-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: 6
- target: $.paths['/draftmessage/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a draft message
      effect: write
      questions:
      - How do I start a new email or SMS as a draft?
      - Can I set a subject and HTML body when creating a message draft?
      instructions:
      - text: Create a draft message named Spring Sale with subject Our spring offers.
      - text: Start a new SMS draft with this text.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/draftmessage/delete'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a draft message
      effect: destructive
      questions:
      - Can I throw away a draft message I no longer need?
      - How do I delete a message draft by its ID?
      instructions:
      - text: Delete draft message {draftMessageId}.
        slots:
          draftMessageId: query.draftMessageId
      - text: Discard the draft with ID {draftMessageId}.
        slots:
          draftMessageId: query.draftMessageId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/draftmessage/find'].post
  update:
    x-apievangelist-phrasing:
      intent: Search draft messages
      effect: read
      questions:
      - Which draft messages were created in the last week?
      - What date format does the draft message filter expect?
      instructions:
      - text: Find draft messages matching the name Newsletter.
      - text: Search our drafts created since the start of the month.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/draftmessage/get'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a draft message
      effect: read
      questions:
      - What subject and body does a specific draft currently have?
      - Can I open one draft message by its ID?
      instructions:
      - text: Get draft message {draftMessageId}.
        slots:
          draftMessageId: query.draftMessageId
      - text: Show me the content of draft {draftMessageId}.
        slots:
          draftMessageId: query.draftMessageId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/draftmessage/saveAsPreparedMessage'].get
  update:
    x-apievangelist-phrasing:
      intent: Turn a draft into a prepared message
      effect: write
      questions:
      - How do I convert a draft into a prepared message for a group?
      - Where do I find the channel ID needed to save a draft as prepared?
      instructions:
      - text: Save draft {draftMessageId} as a prepared message in group {groupId} with sender profile {senderProfileName}.
        slots:
          draftMessageId: query.draftMessageId
          groupId: query.groupId
          senderProfileName: query.senderProfileName
      - text: Prepare draft {draftMessageId} for group {groupId} on channel {channelId} using sender {senderProfileName}.
        slots:
          draftMessageId: query.draftMessageId
          groupId: query.groupId
          channelId: query.channelId
          senderProfileName: query.senderProfileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/draftmessage/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a draft message
      effect: write
      questions:
      - Can I change the subject line of a draft I already created?
      - How do I edit the HTML body of an existing message draft?
      instructions:
      - text: Update draft 18060600 with a new subject line.
      - text: Replace the HTML body of my existing draft.
      method: generated
      generated: '2026-09-26'