# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Elements API
  version: 1.0.0
extends: openapi/salesforce-elements-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: 4
- target: $.paths['/data/v64.0/chatter/feeds/news/me/feed-elements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my Chatter news feed
      effect: read
      questions:
      - What's new in my Chatter feed from groups, people and records I follow?
      - Can I read everything the news feed shows the current user?
      instructions:
      - text: Show my Chatter news feed.
      - text: List the latest feed elements from everything I follow.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/feeds/user-profile/{USER_ID}/feed-elements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's profile feed
      effect: read
      questions:
      - What has a colleague posted or been mentioned in on Chatter?
      - Can I see the record changes a user made that appear on their profile feed?
      instructions:
      - text: Show the profile feed for user {user_id}.
        slots:
          user_id: path.USER_ID
      - text: List feed elements that mention or were posted by {user_id}.
        slots:
          user_id: path.USER_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/feeds/record/{RECORD_GROUP_ID}/feed-elements'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the feed for a record or group
      effect: read
      questions:
      - What discussion has happened on a specific Account's Chatter feed?
      - Can I read the feed of a group by its ID?
      instructions:
      - text: Show the feed elements on record {record_id}.
        slots:
          record_id: path.RECORD_GROUP_ID
      - text: Get the Chatter posts for group or record {record_id}.
        slots:
          record_id: path.RECORD_GROUP_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/feed-elements'].post
  update:
    x-apievangelist-phrasing:
      intent: Post a feed element to a record or user
      effect: write
      questions:
      - How do I post a Chatter update on a record?
      - Is there a character limit on feed item bodies?
      instructions:
      - text: Post {text} to the feed of {subject}.
        slots:
          text: query.text
          subject: query.subjectId
      - text: Create a {type} feed element on {subject} saying {text}.
        slots:
          type: query.feedElementType
          subject: query.subjectId
          text: query.text
      method: generated
      generated: '2026-09-26'