# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST Group Users API
  version: 1.0.0
extends: openapi/docusign-group-users-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/v2/accounts/{accountId}/groups/{groupId}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List users in a group
      effect: read
      questions:
      - Who is in a particular user group?
      - Can I page through the members of a large group?
      instructions:
      - text: List users in group {group} in account {account}.
        slots:
          group: path.groupId
          account: path.accountId
      - text: List {count} members of group {group} starting at {start_position}.
        slots:
          count: query.count
          group: path.groupId
          start_position: query.start_position
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/groups/{groupId}/users'].put
  update:
    x-apievangelist-phrasing:
      intent: Add users to a group
      effect: write
      questions:
      - How do I add people to an existing group?
      - Can I add several users to a group at once?
      instructions:
      - text: Add users {users} to group {group} in account {account}.
        slots:
          users: requestBody.users
          group: path.groupId
          account: path.accountId
      - text: Put {users} into group {group}.
        slots:
          users: requestBody.users
          group: path.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/groups/{groupId}/users'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove users from a group
      effect: destructive
      questions:
      - How do I take users out of a group?
      - Can I remove multiple members from a group in one call?
      instructions:
      - text: Remove users {users} from group {group} in account {account}.
        slots:
          users: requestBody.users
          group: path.groupId
          account: path.accountId
      - text: Take {users} out of group {group}.
        slots:
          users: requestBody.users
          group: path.groupId
      method: generated
      generated: '2026-10-01'