# 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 Account Custom Fields API
  version: 1.0.0
extends: openapi/docusign-accountcustomfields-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: 4
- target: $.paths['/v2/accounts/{accountId}/custom_fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List account-level envelope custom fields
      effect: read
      questions:
      - What envelope custom fields are defined for my account?
      - Which custom fields can senders use to tag envelopes for search and reporting?
      instructions:
      - text: List the account custom fields for account {account}.
        slots:
          account: path.accountId
      - text: Show envelope custom field definitions in account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/custom_fields'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an account custom field
      effect: write
      questions:
      - How do I add a new custom field that all envelopes in my account can use?
      - Can I create a list-type custom field with fixed choices?
      instructions:
      - text: Create an account custom field named {name} in account {account}.
        slots:
          name: requestBody.name
          account: path.accountId
      - text: 'Create list custom field {name} with items {listItems}, required: {required}.'
        slots:
          name: requestBody.name
          listItems: requestBody.listItems
          required: requestBody.required
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/custom_fields/{customFieldId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an account custom field
      effect: write
      questions:
      - How do I change the options on an existing account custom field?
      - Can I apply a custom field change to my templates too?
      instructions:
      - text: Update account custom field {field} in account {account} to name {name}.
        slots:
          field: path.customFieldId
          account: path.accountId
          name: requestBody.name
      - text: 'Change list items of account custom field {field} to {listItems}, applying to templates: {apply_to_templates}.'
        slots:
          field: path.customFieldId
          listItems: requestBody.listItems
          apply_to_templates: query.apply_to_templates
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/custom_fields/{customFieldId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an account custom field
      effect: destructive
      questions:
      - How do I remove an account-wide custom field?
      - Can I delete a custom field from templates at the same time?
      instructions:
      - text: Delete account custom field {field} from account {account}.
        slots:
          field: path.customFieldId
          account: path.accountId
      - text: 'Delete account custom field {field} and remove it from templates: {apply_to_templates}.'
        slots:
          field: path.customFieldId
          apply_to_templates: query.apply_to_templates
      method: generated
      generated: '2026-10-01'