# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kinde Management Billing Meter Usage API
  version: 1.0.0
extends: openapi/kinde-billing-meter-usage-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 1
- target: $.paths['/api/v1/billing/meter_usage'].post
  update:
    x-apievangelist-phrasing:
      intent: Record metered usage for a customer
      effect: write
      questions:
      - What's the way to report usage for a metered billing feature?
      - Can I backdate a meter usage record with its own timestamp?
      instructions:
      - text: Record {meter_value} units of {billing_feature_code} on agreement {customer_agreement_id}.
        slots:
          meter_value: requestBody.meter_value
          billing_feature_code: requestBody.billing_feature_code
          customer_agreement_id: requestBody.customer_agreement_id
      - text: Log usage of {meter_value} for feature {billing_feature_code} on agreement {customer_agreement_id} at {meter_usage_timestamp}.
        slots:
          meter_value: requestBody.meter_value
          billing_feature_code: requestBody.billing_feature_code
          customer_agreement_id: requestBody.customer_agreement_id
          meter_usage_timestamp: requestBody.meter_usage_timestamp
      method: generated
      generated: '2026-09-26'