# 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'