API Evangelist conversational phrasing for DocuSign REST Power Forms 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 REST Power Forms API
  version: 1.0.0
extends: openapi/docusign-powerforms-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: 7
- target: $.paths['/v2/accounts/{accountId}/powerforms'].get
  update:
    x-apievangelist-phrasing:
      intent: List my PowerForms
      effect: read
      questions:
      - Which self-service PowerForms are available to me?
      - Can I list PowerForms created within a date range?
      instructions:
      - text: List the PowerForms in account {accountId}.
        slots:
          accountId: path.accountId
      - text: Show PowerForms from {from_date} to {to_date} ordered by {order_by}.
        slots:
          from_date: query.from_date
          to_date: query.to_date
          order_by: query.order_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/powerforms'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a PowerForm from a template
      effect: write
      questions:
      - Can I turn a template into a self-service PowerForm link people can sign from?
      - Is it possible to cap how many times a new PowerForm can be used?
      instructions:
      - text: Create a PowerForm named {name} from template {templateId} in account {accountId}.
        slots:
          name: requestBody.name
          templateId: requestBody.templateId
          accountId: path.accountId
      - text: Set up a new PowerForm {name} with signing mode {signingMode} and email subject {emailSubject}.
        slots:
          name: requestBody.name
          signingMode: requestBody.signingMode
          emailSubject: requestBody.emailSubject
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/powerforms'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several PowerForms at once
      effect: destructive
      questions:
      - Can I delete multiple PowerForms in a single request?
      - What's the bulk way to clear out old PowerForms?
      instructions:
      - text: Delete PowerForms {powerForms} from account {accountId}.
        slots:
          powerForms: requestBody.powerForms
          accountId: path.accountId
      - text: 'Remove this batch of PowerForms: {powerForms}.'
        slots:
          powerForms: requestBody.powerForms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/powerforms/{powerFormId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one PowerForm
      effect: read
      questions:
      - Can I see the settings and URL of one particular PowerForm?
      - How many times has a specific PowerForm been used?
      instructions:
      - text: Get PowerForm {powerFormId}.
        slots:
          powerFormId: path.powerFormId
      - text: Show the details of PowerForm {powerFormId} in account {accountId}.
        slots:
          powerFormId: path.powerFormId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/powerforms/{powerFormId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing PowerForm
      effect: write
      questions:
      - Can I deactivate an existing PowerForm or change its instructions?
      - Is it possible to change the email subject of a PowerForm I already have?
      instructions:
      - text: Rename PowerForm {powerFormId} to {name}.
        slots:
          powerFormId: path.powerFormId
          name: requestBody.name
      - text: Set PowerForm {powerFormId} in account {accountId} active status to {isActive}.
        slots:
          powerFormId: path.powerFormId
          accountId: path.accountId
          isActive: requestBody.isActive
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/powerforms/{powerFormId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single PowerForm
      effect: destructive
      questions:
      - Can I delete one PowerForm by its ID?
      - What happens to a PowerForm link once it is deleted?
      instructions:
      - text: Delete PowerForm {powerFormId}.
        slots:
          powerFormId: path.powerFormId
      - text: Remove PowerForm {powerFormId} from account {accountId}.
        slots:
          powerFormId: path.powerFormId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/powerforms/senders'].get
  update:
    x-apievangelist-phrasing:
      intent: List PowerForm senders
      effect: read
      questions:
      - Who are the senders behind the PowerForms in my account?
      - Can I page through the list of PowerForm senders?
      instructions:
      - text: List the PowerForm senders in account {accountId}.
        slots:
          accountId: path.accountId
      - text: Show PowerForm senders starting at position {start_position}.
        slots:
          start_position: query.start_position
      method: generated
      generated: '2026-10-01'