API Evangelist conversational phrasing for Docusign Accounts API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Docusign Accounts API
  version: 1.0.0
extends: openapi/docusign-accounts-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: 14
- target: $.paths['/v2/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create one or more new eSignature accounts
      effect: write
      questions:
      - How do I programmatically create a new DocuSign account for a customer?
      - Can I create up to 100 accounts in a single request?
      - Is there a way to preview the billing plan before the account is created?
      instructions:
      - text: Create a new account named {name} with initial user {user}.
        slots:
          name: requestBody.accountName
          user: requestBody.initialUser
      - text: Create account {name} on plan {plan} and preview the billing first.
        slots:
          name: requestBody.accountName
          plan: requestBody.planInformation
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account's information
      effect: read
      questions:
      - Where can I see the basic details of my eSignature account?
      - Can this account be upgraded through the API?
      instructions:
      - text: Get the account information for account {account}.
        slots:
          account: path.accountId
      - text: Show account {account} including its account settings.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Close an account
      effect: destructive
      questions:
      - What happens when I close my eSignature account?
      - Can a closed account be reopened by myself afterwards?
      instructions:
      - text: Close account {account}.
        slots:
          account: path.accountId
      - text: Permanently shut down eSignature account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/billing_charges'].get
  update:
    x-apievangelist-phrasing:
      intent: List recurring and usage charges for an account
      effect: read
      questions:
      - What recurring and usage charges are on my account?
      - Which charge plan items has my account used so far?
      instructions:
      - text: List billing charges for account {account}.
        slots:
          account: path.accountId
      - text: Show only the {charges} charges on account {account}.
        slots:
          charges: query.include_charges
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/captive_recipients/{recipientPart}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset signatures for captive recipients
      effect: destructive
      questions:
      - Can I reset the saved signature for an embedded signer during testing?
      - Why would I clear captive recipient signatures tied to a client user ID?
      instructions:
      - text: Delete the {part} for captive recipients {recipients} in account {account}.
        slots:
          part: path.recipientPart
          recipients: requestBody.captiveRecipients
          account: path.accountId
      - text: Reset the stored signature for captive recipients in account {account} using part {part}.
        slots:
          account: path.accountId
          part: path.recipientPart
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/recipient_names'].get
  update:
    x-apievangelist-phrasing:
      intent: Find recipient names linked to an email
      effect: read
      questions:
      - Which recipient names are tied to a particular email address in my account?
      - Can one email address map to several recipient names?
      instructions:
      - text: Find the recipient names associated with {email} in account {account}.
        slots:
          email: query.email
          account: path.accountId
      - text: Look up every name used by email {email}.
        slots:
          email: query.email
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get account-wide settings
      effect: read
      questions:
      - What account-level settings are currently enabled for us?
      - How can I review my account's configuration before changing it?
      instructions:
      - text: Get the settings for account {account}.
        slots:
          account: path.accountId
      - text: Show me every account setting configured on {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update account-wide settings
      effect: write
      questions:
      - Can I change account-level settings through the API?
      - Is it possible to update several account settings at once?
      instructions:
      - text: Update account {account} with settings {settings}.
        slots:
          account: path.accountId
          settings: requestBody.accountSettings
      - text: Apply the account settings {settings} to account {account}.
        slots:
          settings: requestBody.accountSettings
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/shared_access'].get
  update:
    x-apievangelist-phrasing:
      intent: See who shares envelopes or templates
      effect: read
      questions:
      - Which users have shared access to other users' envelopes?
      - Can non-admins only see their own shared-item status?
      - Can I filter shared access by item type or folder?
      instructions:
      - text: Show shared access status for users {users} in account {account}.
        slots:
          users: query.user_ids
          account: path.accountId
      - text: List shared {item_type} items in account {account}.
        slots:
          item_type: query.item_type
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/shared_access'].put
  update:
    x-apievangelist-phrasing:
      intent: Set shared access for users or templates
      effect: write
      questions:
      - How can I let one user see another user's envelopes?
      - Who is allowed to change template sharing?
      instructions:
      - text: Set shared access {shared_access} for users {users} in account {account}.
        slots:
          shared_access: requestBody.sharedAccess
          users: query.user_ids
          account: path.accountId
      - text: Share {item_type} items in account {account} according to {shared_access}.
        slots:
          item_type: query.item_type
          account: path.accountId
          shared_access: requestBody.sharedAccess
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/supported_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages available for recipients
      effect: read
      questions:
      - Which languages can I choose for a recipient's signing experience?
      - Is there a list of supported recipient language settings?
      instructions:
      - text: List the supported recipient languages for account {account}.
        slots:
          account: path.accountId
      - text: Show which signer languages account {account} supports.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/unsupported_file_types'].get
  update:
    x-apievangelist-phrasing:
      intent: List file types that cannot be uploaded
      effect: read
      questions:
      - Which file extensions am I not allowed to upload as documents?
      - Can I check whether a mime type is blocked before uploading?
      instructions:
      - text: List the unsupported file types for account {account}.
        slots:
          account: path.accountId
      - text: Show which mime types and extensions account {account} rejects.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/provisioning'].get
  update:
    x-apievangelist-phrasing:
      intent: Get account provisioning information
      effect: read
      questions:
      - What provisioning information is available for my account?
      - Where do I find the distributor provisioning details for my integration?
      instructions:
      - text: Get the account provisioning information.
      - text: Show me the provisioning details for this account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organization_exports/{organizationId}/account_settings/{resultId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of an account settings export
      effect: read
      questions:
      - Can I fetch the results of an organization's account settings export?
      - Where do I pick up a finished settings export by its result ID?
      instructions:
      - text: Get account settings export result {result} for organization {organization}.
        slots:
          result: path.resultId
          organization: path.organizationId
      - text: Show export {result} of account settings in organization {organization}.
        slots:
          result: path.resultId
          organization: path.organizationId
      method: generated
      generated: '2026-10-01'