# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Billing Management Preferences API
  version: 1.0.0
extends: openapi/conga-preferences-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['/preferences'].get
  update:
    x-apievangelist-phrasing:
      intent: List billing preferences
      effect: read
      questions:
      - Which billing preferences are configured?
      - Can I filter billing preferences?
      instructions:
      - text: List all billing preferences.
      - text: List preferences matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/preferences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create billing preferences
      effect: write
      questions:
      - How do I create a new billing preference?
      - Can I add several preferences at once?
      instructions:
      - text: Create new billing preferences.
      - text: Add a batch of preference records.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/preferences'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update billing preferences
      effect: write
      questions:
      - Can I edit several billing preferences in one request?
      - How do I bulk-update preference records?
      instructions:
      - text: Bulk update the selected billing preferences.
      - text: Edit many preference records at once.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/preferences/activate'].patch
  update:
    x-apievangelist-phrasing:
      intent: Activate or deactivate preferences in bulk
      effect: write
      questions:
      - Can I switch several billing preferences on or off at once?
      - How do I deactivate a list of preferences?
      instructions:
      - text: Activate or deactivate the listed preferences.
      - text: Toggle the active state of several billing preferences.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/preferences/{id}/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Make a preference the default
      effect: write
      questions:
      - How do I set the default billing preference?
      - Can I change which preference is default?
      instructions:
      - text: Make preference {id} the default.
        slots:
          id: path.id
      - text: Set {id} as our default billing preference.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/preferences/{preferenceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a billing preference
      effect: read
      questions:
      - Where can I see one billing preference?
      - What does a specific preference record define?
      instructions:
      - text: Get billing preference {id}.
        slots:
          id: path.preferenceId
      - text: Show preference record {id} including {includes}.
        slots:
          id: path.preferenceId
          includes: query.includes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/preferences/{preferenceId}/activate'].patch
  update:
    x-apievangelist-phrasing:
      intent: Activate or deactivate one preference
      effect: write
      questions:
      - Can I deactivate a single billing preference?
      - How do I turn one preference back on?
      instructions:
      - text: Set preference {id} active to {active}.
        slots:
          id: path.preferenceId
          active: query.active
      - text: Deactivate only preference {id}.
        slots:
          id: path.preferenceId
      method: generated
      generated: '2026-10-01'