# 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 Account Password Rules API
  version: 1.0.0
extends: openapi/docusign-accountpasswordrules-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}/settings/password_rules'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account's password rules
      effect: read
      questions:
      - What password policy is set for my account, like minimum length and expiry?
      - Can an admin see the account's lockout and password strength settings?
      instructions:
      - text: Show the password rules for account {accountId}.
        slots:
          accountId: path.accountId
      - text: Get the password policy configured on account {accountId}.
        slots:
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/settings/password_rules'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an account's password rules
      effect: write
      questions:
      - Can I require passwords to include digits or special characters?
      - Is it possible to make account passwords expire after a number of days?
      instructions:
      - text: Set the minimum password length for account {accountId} to {minimumPasswordLength}.
        slots:
          accountId: path.accountId
          minimumPasswordLength: requestBody.minimumPasswordLength
      - text: Make passwords in account {accountId} expire every {expirePasswordDays} days.
        slots:
          accountId: path.accountId
          expirePasswordDays: requestBody.expirePasswordDays
      - text: Lock users out for {lockoutDurationMinutes} minutes after failed logins in account {accountId}.
        slots:
          lockoutDurationMinutes: requestBody.lockoutDurationMinutes
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/current_user/password_rules'].get
  update:
    x-apievangelist-phrasing:
      intent: Get password rules for my membership account
      effect: read
      questions:
      - What password requirements apply to me as the current user?
      - Which password rules do I need to follow when changing my own password?
      instructions:
      - text: Show the password rules that apply to my current user.
      - text: Get my membership account password requirements.
      method: generated
      generated: '2026-10-01'