# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Groups API
  version: 1.0.0
extends: openapi/salesforce-groups-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: 7
- target: $.paths['/data/v64.0/chatter/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List Chatter groups in the org
      effect: read
      questions:
      - Which Chatter groups exist in my organization?
      - Can I see every group in the org with its visibility?
      instructions:
      - text: List all Chatter groups in the org.
      - text: Show me the groups people can join in Chatter.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Chatter group
      effect: write
      questions:
      - How do I create a new private Chatter group?
      - Can I make a broadcast-only group that allows Chatter guests?
      instructions:
      - text: Create a Chatter group named {name} with {visibility} visibility.
        slots:
          name: query.name
          visibility: query.visibility
      - text: Start a group {name} described as {description}, broadcast only set to {broadcast}.
        slots:
          name: query.name
          description: query.description
          broadcast: query.isBroadcast
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/groups/{GROUP_ID}/members/requests'].get
  update:
    x-apievangelist-phrasing:
      intent: See pending requests to join a private group
      effect: read
      questions:
      - Who has asked to join my private Chatter group?
      - What is the status of membership requests for a private group?
      instructions:
      - text: List the join requests for private group {group_id}.
        slots:
          group_id: path.GROUP_ID
      - text: Show pending membership requests on group {group_id}.
        slots:
          group_id: path.GROUP_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/groups/{GROUP_ID}/members/requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request to join a private group
      effect: write
      questions:
      - Can I ask to join a private Chatter group I'm not a member of?
      - What happens when I request membership in a private group?
      instructions:
      - text: Request membership in private group {group_id}.
        slots:
          group_id: path.GROUP_ID
      - text: Ask the owner of group {group_id} to let me join.
        slots:
          group_id: path.GROUP_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/groups/group/{GROUP_ID}/invite'].post
  update:
    x-apievangelist-phrasing:
      intent: Invite people to a Chatter group
      effect: write
      questions:
      - Can I invite external users as well as colleagues to a group?
      - Is there a way to send a personal message with a group invitation?
      instructions:
      - text: Invite {invitees} to group {group_id}.
        slots:
          invitees: requestBody.invitees
          group_id: path.GROUP_ID
      - text: Send a group {group_id} invite to {invitees} saying {message}.
        slots:
          group_id: path.GROUP_ID
          invitees: requestBody.invitees
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/groups/{GROUP_ID}/members'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a member to a Chatter group
      effect: write
      questions:
      - Who is allowed to add a member directly to a Chatter group?
      - Can a group owner add a user without an invitation?
      instructions:
      - text: Add user {user_id} to group {group_id}.
        slots:
          user_id: query.userId
          group_id: path.GROUP_ID
      - text: Put {user_id} into Chatter group {group_id} as a member.
        slots:
          user_id: query.userId
          group_id: path.GROUP_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/chatter/group-membership-requests/{CHATTER_GROUP_REQUEST_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Approve or decline a private group join request
      effect: write
      questions:
      - How do I accept someone's request to join my private group?
      - Can I decline a join request and include a reason?
      instructions:
      - text: Set join request {request_id} to {status}.
        slots:
          request_id: path.CHATTER_GROUP_REQUEST_ID
          status: query.status
      - text: Decline membership request {request_id} with the message {response}.
        slots:
          request_id: path.CHATTER_GROUP_REQUEST_ID
          response: query.responseMessage
      method: generated
      generated: '2026-09-26'