# 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 Signing Groups API
  version: 1.0.0
extends: openapi/docusign-signinggroups-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: 6
- target: $.paths['/v2/accounts/{accountId}/signing_groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List signing groups in an account
      effect: read
      questions:
      - Which signing groups exist in my account?
      - Can I include each group's members when listing signing groups?
      instructions:
      - text: List the signing groups in account {accountId}.
        slots:
          accountId: path.accountId
      - text: Show signing groups of type {group_type} with their users.
        slots:
          group_type: query.group_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/signing_groups'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename several signing groups
      effect: write
      questions:
      - Can I rename more than one signing group in a single request?
      - Is there a bulk way to change signing group names?
      instructions:
      - text: Rename the signing groups {groups} in account {accountId}.
        slots:
          groups: requestBody.groups
          accountId: path.accountId
      - text: 'Apply these new signing group names: {groups}.'
        slots:
          groups: requestBody.groups
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/signing_groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create signing groups
      effect: write
      questions:
      - How many signing groups and members can an account have?
      - Who is allowed to create signing groups?
      instructions:
      - text: Create signing groups {groups} in account {accountId}.
        slots:
          groups: requestBody.groups
          accountId: path.accountId
      - text: 'Add these new signing groups: {groups}.'
        slots:
          groups: requestBody.groups
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/signing_groups'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete signing groups
      effect: destructive
      questions:
      - Can I delete one or more signing groups at once?
      - What's the way to remove a signing group we no longer use?
      instructions:
      - text: Delete signing groups {groups} from account {accountId}.
        slots:
          groups: requestBody.groups
          accountId: path.accountId
      - text: 'Remove these signing groups: {groups}.'
        slots:
          groups: requestBody.groups
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/signing_groups/{signingGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a signing group and its members
      effect: read
      questions:
      - Who are the members of a specific signing group?
      - Can I look up one signing group's details by ID?
      instructions:
      - text: Show signing group {signingGroupId} and its members.
        slots:
          signingGroupId: path.signingGroupId
      - text: Get signing group {signingGroupId} in account {accountId}.
        slots:
          signingGroupId: path.signingGroupId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/signing_groups/{signingGroupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a signing group's name or members
      effect: write
      questions:
      - Can I add new members to an existing signing group?
      - Is there a member limit when updating a signing group?
      instructions:
      - text: Rename signing group {signingGroupId} to {groupName}.
        slots:
          signingGroupId: path.signingGroupId
          groupName: requestBody.groupName
      - text: Set the members of signing group {signingGroupId} in account {accountId} to {users}.
        slots:
          signingGroupId: path.signingGroupId
          accountId: path.accountId
          users: requestBody.users
      method: generated
      generated: '2026-10-01'