# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Use Cases > Conversation Ad > Sponsored Message Contents API
  version: 1.0.0
extends: openapi/linkedin-use-cases-conversation-ad-sponsored-message-contents-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['/conversationAds/{conversationAdsId}/sponsoredMessageContents'].post
  update:
    x-apievangelist-phrasing:
      intent: Batch create messages for a conversation ad
      effect: write
      questions:
      - Can I add several messages to a conversation ad at once?
      - What's the way to create the message tree for a sponsored conversation?
      instructions:
      - text: Batch create sponsored message content for conversation {conversationAdsId}.
        slots:
          conversationAdsId: path.conversationAdsId
      - text: Add the new messages to conversation ad {conversationAdsId}.
        slots:
          conversationAdsId: path.conversationAdsId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/conversationAds/{conversationUrn}/sponsoredMessageContents/{messageUrn}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one message from a conversation ad
      effect: read
      questions:
      - Can I read the text of a single message in a conversation ad?
      - Which content does one specific sponsored message hold?
      instructions:
      - text: Get message {messageUrn} from conversation {conversationUrn}.
        slots:
          messageUrn: path.messageUrn
          conversationUrn: path.conversationUrn
      - text: Show sponsored message {messageUrn} in {conversationUrn}.
        slots:
          messageUrn: path.messageUrn
          conversationUrn: path.conversationUrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/conversationAds/{conversationUrn}/sponsoredMessageContents/{messageUrn}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update one message in a conversation ad
      effect: write
      questions:
      - Can I edit the wording of one message in my conversation ad?
      - Is it possible to change a single sponsored message without touching the others?
      instructions:
      - text: Update message {messageUrn} in conversation {conversationUrn}.
        slots:
          messageUrn: path.messageUrn
          conversationUrn: path.conversationUrn
      - text: Rewrite the single sponsored message {messageUrn} of {conversationUrn}.
        slots:
          messageUrn: path.messageUrn
          conversationUrn: path.conversationUrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/conversationAds/{conversationUrn}/sponsoredMessageContents'].get
  update:
    x-apievangelist-phrasing:
      intent: Batch get messages in a conversation ad
      effect: read
      questions:
      - Can I fetch several messages from a conversation ad in one call?
      - Which messages make up a given sponsored conversation?
      instructions:
      - text: Batch get messages {ids} from conversation {conversationUrn}.
        slots:
          ids: query.ids
          conversationUrn: path.conversationUrn
      - text: Retrieve all listed message contents of {conversationUrn}.
        slots:
          conversationUrn: path.conversationUrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/conversationAds/{conversationUrn}/sponsoredMessageContents'].post
  update:
    x-apievangelist-phrasing:
      intent: Batch update messages in a conversation ad
      effect: write
      questions:
      - Can I update many conversation ad messages in one request?
      - Is there a bulk edit for sponsored message content?
      instructions:
      - text: Batch update messages {ids} in conversation {conversationUrn}.
        slots:
          ids: query.ids
          conversationUrn: path.conversationUrn
      - text: Apply bulk edits to the message set of {conversationUrn}.
        slots:
          conversationUrn: path.conversationUrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/conversationAds/{conversationUrn}/sponsoredMessageContents'].delete
  update:
    x-apievangelist-phrasing:
      intent: Batch delete messages from a conversation ad
      effect: destructive
      questions:
      - Can I remove several messages from a conversation ad at once?
      - What happens if I bulk delete sponsored message content?
      instructions:
      - text: Delete messages {ids} from conversation {conversationUrn}.
        slots:
          ids: query.ids
          conversationUrn: path.conversationUrn
      - text: Batch remove message content from conversation ad {conversationUrn}.
        slots:
          conversationUrn: path.conversationUrn
      method: generated
      generated: '2026-09-26'