# 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 Multi Product User Management API
  version: 1.0.0
extends: openapi/docusign-multiproductusermanagement-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: 11
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List DS groups in an account
      effect: read
      questions:
      - Which DS groups exist on an account in my organization?
      - Can I page through DS groups with a page size?
      instructions:
      - text: List the DS groups in account {account} of organization {org}.
        slots:
          account: path.accountId
          org: path.organizationId
      - text: Show page {page} of DS groups for account {account} in org {org}.
        slots:
          page: query.page
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a DS group
      effect: write
      questions:
      - How do I create a new DS group for an account?
      - Can I give a DS group a description when creating it?
      instructions:
      - text: Create a DS group named {name} in account {account} of org {org}.
        slots:
          name: requestBody.group_name
          account: path.accountId
          org: path.organizationId
      - text: Add DS group {name} with description {desc} to account {account} in org {org}.
        slots:
          name: requestBody.group_name
          desc: requestBody.description
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a DS group
      effect: read
      questions:
      - What details can I see about a single DS group?
      - How do I look up one DS group by its ID?
      instructions:
      - text: Get DS group {group} in account {account} of org {org}.
        slots:
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      - text: Show the details of DS group {group} for account {account}, org {org}.
        slots:
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DS group
      effect: destructive
      questions:
      - Can I delete a DS group I no longer need?
      - Which scope is required to remove a DS group?
      instructions:
      - text: Delete DS group {group} from account {account} in org {org}.
        slots:
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      - text: Remove the DS group {group} in org {org}, account {account}.
        slots:
          group: path.dsGroupId
          org: path.organizationId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List the members of a DS group
      effect: read
      questions:
      - Who are the members of a particular DS group?
      - Can I paginate the user list of a DS group?
      instructions:
      - text: List users in DS group {group}, account {account}, org {org}.
        slots:
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      - text: Show who belongs to DS group {group} in account {account} of org {org}.
        slots:
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Add users to a DS group
      effect: write
      questions:
      - How do I add several users to a DS group at once?
      - Can I add members to a DS group by user ID?
      instructions:
      - text: Add users {user_ids} to DS group {group} in account {account}, org {org}.
        slots:
          user_ids: requestBody.user_ids
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      - text: Put these user IDs {user_ids} into DS group {group} for account {account} in org {org}.
        slots:
          user_ids: requestBody.user_ids
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/dsgroups/{dsGroupId}/users'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove users from a DS group
      effect: destructive
      questions:
      - Can I remove a list of users from a DS group in one request?
      - How do I take members out of a DS group without deleting the group?
      instructions:
      - text: Remove users {user_ids} from DS group {group} in account {account}, org {org}.
        slots:
          user_ids: requestBody.user_ids
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      - text: Drop {user_ids} from DS group {group}, account {account}, org {org}.
        slots:
          user_ids: requestBody.user_ids
          group: path.dsGroupId
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/products/permission_profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List products and permission profiles for an account
      effect: read
      questions:
      - Which products does an account have and what permission profiles are available for each?
      - Where can I see the product permission profiles I can assign?
      instructions:
      - text: List the products and available permission profiles for account {account} in org {org}.
        slots:
          account: path.accountId
          org: path.organizationId
      - text: Show product permission profile options on account {account}, org {org}.
        slots:
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/products/users/{userId}/permission_profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's permission profile per product
      effect: read
      questions:
      - What permission profile does a user have in each product on an account?
      - Can I check one user's product-level permissions?
      instructions:
      - text: Show user {user}'s product permission profiles in account {account}, org {org}.
        slots:
          user: path.userId
          account: path.accountId
          org: path.organizationId
      - text: Get the per-product permission profiles of {user} on account {account} in org {org}.
        slots:
          user: path.userId
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/products/users/{userId}/permission_profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a user to product permission profiles
      effect: write
      questions:
      - How do I give an existing user a permission profile for a specific product?
      - Can I assign profiles for several products to one user at once?
      instructions:
      - text: Assign user {user} to product permission profiles {profiles} in account {account}, org {org}.
        slots:
          user: path.userId
          profiles: requestBody.product_permission_profiles
          account: path.accountId
          org: path.organizationId
      - text: Set {user}'s product permissions to {profiles} on account {account} in org {org}.
        slots:
          user: path.userId
          profiles: requestBody.product_permission_profiles
          account: path.accountId
          org: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2.1/organizations/{organizationId}/accounts/{accountId}/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update a multi-product user
      effect: write
      questions:
      - How do I add a user who needs access to several DocuSign products?
      - Can one call both create a user and set their product permission profiles and DS groups?
      instructions:
      - text: Create multi-product user {email} in account {account}, org {org} with permission profiles {profiles}.
        slots:
          email: requestBody.email
          account: path.accountId
          org: path.organizationId
          profiles: requestBody.product_permission_profiles
      - text: Add {email} to account {account} in org {org} with profiles {profiles} and DS groups {groups}.
        slots:
          email: requestBody.email
          account: path.accountId
          org: path.organizationId
          profiles: requestBody.product_permission_profiles
          groups: requestBody.ds_groups
      method: generated
      generated: '2026-10-01'