# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynamicfeed Ai Billing API
  version: 1.0.0
extends: openapi/dynamicfeed-ai-billing-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: 3
- target: $.paths['/billing/checkout'].post
  update:
    x-apievangelist-phrasing:
      intent: Start checkout to upgrade an API key
      effect: write
      questions:
      - How much do the pro, ultra and mega plans cost per month?
      - Can I pay annually to get two months free?
      - Which plan tiers can I upgrade my key to?
      instructions:
      - text: Start checkout to upgrade key {api_key} to the {tier} plan.
        slots:
          api_key: query.api_key
          tier: query.tier
      - text: Upgrade {api_key} to {tier} billed {interval}.
        slots:
          api_key: query.api_key
          tier: query.tier
          interval: query.interval
      method: generated
      generated: '2026-10-01'
- target: $.paths['/billing/success'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the post-payment success page
      effect: read
      questions:
      - What page do I land on after completing a plan payment?
      - Is there a confirmation page after a successful checkout?
      instructions:
      - text: Open the billing success page.
      - text: Show the payment confirmation page.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/billing/webhook'].post
  update:
    x-apievangelist-phrasing:
      intent: Receive payment confirmation events
      effect: write
      questions:
      - How does my key get upgraded or downgraded after a payment event?
      - Which endpoint receives payment confirmation callbacks?
      instructions:
      - text: Deliver a payment confirmation event to the billing webhook.
      - text: Process a signed payment event to change a key's plan.
      method: generated
      generated: '2026-10-01'