# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign Admin E Sign User Management API
  version: 1.0.0
extends: openapi/docusign-esignusermanagement-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: 9
- target: $.paths['/v2/organizations/{organizationId}/accounts/{accountId}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an account's permission profiles from the org
      effect: read
      questions:
      - Which permission profiles exist in one of my organization's accounts?
      - Can an org admin see an account's permission profiles?
      instructions:
      - text: List permission profiles for account {account} in organization {organization}.
        slots:
          account: path.accountId
          organization: path.organizationId
      - text: Show account {account}'s permission profiles.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/accounts/{accountId}/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List an account's groups from the org
      effect: read
      questions:
      - What groups are set up in a specific account under my organization?
      - Can I page through an account's groups?
      instructions:
      - text: List groups in account {account} of organization {organization}.
        slots:
          account: path.accountId
          organization: path.organizationId
      - text: Show the first {take} groups in account {account}.
        slots:
          take: query.take
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/users/profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Update users' profile information
      effect: write
      questions:
      - How do I change a user's name or details across the organization?
      - Can I update several user profiles in one request?
      instructions:
      - text: Update the user profiles {users} in organization {organization}.
        slots:
          users: requestBody.users
          organization: path.organizationId
      - text: Apply profile changes {users} to my organization's users.
        slots:
          users: requestBody.users
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/users/{userId}/accounts'].delete
  update:
    x-apievangelist-phrasing:
      intent: Close a user's account memberships
      effect: destructive
      questions:
      - How do I remove a user's access to specific accounts in my organization?
      - Can I close only some of a user's account memberships?
      instructions:
      - text: Close user {user}'s memberships in accounts {accounts} for organization {organization}.
        slots:
          user: path.userId
          accounts: requestBody.accounts
          organization: path.organizationId
      - text: Revoke user {user} from accounts {accounts}.
        slots:
          user: path.userId
          accounts: requestBody.accounts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new user in the organization
      effect: write
      questions:
      - How do I add a brand-new user to my organization with access to accounts?
      - Can a new user's memberships be activated automatically?
      instructions:
      - text: Create a user with email {email} in organization {organization} and give them accounts {accounts}.
        slots:
          email: requestBody.email
          organization: path.organizationId
          accounts: requestBody.accounts
      - text: Add {first_name} {last_name} ({email}) to organization {organization} with accounts {accounts}.
        slots:
          first_name: requestBody.first_name
          last_name: requestBody.last_name
          email: requestBody.email
          organization: path.organizationId
          accounts: requestBody.accounts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/users/{userId}/memberships/{membershipId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a user's membership
      effect: write
      questions:
      - How can I activate a pending membership for an organization user?
      - What do I need to turn on a user's membership in an account?
      instructions:
      - text: Activate membership {membership} for user {user} in organization {organization} on site {site}.
        slots:
          membership: path.membershipId
          user: path.userId
          organization: path.organizationId
          site: requestBody.site_id
      - text: Turn on user {user}'s membership {membership}.
        slots:
          user: path.userId
          membership: path.membershipId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/users/profile'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up recently modified users
      effect: read
      questions:
      - Which users in my organization were changed in the last ten days?
      - Can I look up a recently modified user's profile by email?
      instructions:
      - text: Show recently modified users in organization {organization}.
        slots:
          organization: path.organizationId
      - text: Get the profile of recently changed user {email} in organization {organization}.
        slots:
          email: query.email
          organization: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/users/{userId}/identities'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user's login identities
      effect: destructive
      questions:
      - Can I remove a linked login identity from a user?
      - How do I clear stale identities off an organization user?
      instructions:
      - text: Delete identities {identities} from user {user} in organization {organization}.
        slots:
          identities: requestBody.identities
          user: path.userId
          organization: path.organizationId
      - text: Remove login identities {identities} for user {user}.
        slots:
          identities: requestBody.identities
          user: path.userId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/accounts/{accountId}/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a user to a specific account
      effect: write
      questions:
      - How do I add an existing person to one account with a permission profile?
      - Can I put a newly added account user into groups straight away?
      instructions:
      - text: Add {email} to account {account} in organization {organization}.
        slots:
          email: requestBody.email
          account: path.accountId
          organization: path.organizationId
      - text: Add {email} to account {account} with permission profile {profile} and groups {groups}.
        slots:
          email: requestBody.email
          account: path.accountId
          profile: requestBody.permission_profile
          groups: requestBody.groups
      method: generated
      generated: '2026-10-01'