# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure CustomerInsightsManagementClient Kpi API
  version: 1.0.0
extends: openapi/microsoft-azure-kpi-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/kpi/{kpiName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a KPI in a Customer Insights hub
      effect: read
      questions:
      - How do I read the definition of one KPI in my Customer Insights hub?
      - What calculation does a specific hub KPI use?
      instructions:
      - text: Get KPI {kpi} in hub {hub}, resource group {group}.
        slots:
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      - text: Show the definition of KPI {kpi} in Customer Insights hub {hub} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/kpi/{kpiName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a hub KPI
      effect: write
      questions:
      - How do I define a new KPI in Customer Insights?
      - Can I change an existing KPI's definition?
      instructions:
      - text: Create KPI {kpi} in hub {hub}, group {group}.
        slots:
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      - text: Create or update KPI {kpi} in {hub} ({group}, subscription {subscription}) with properties {properties}.
        slots:
          subscription: path.subscriptionId
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/kpi/{kpiName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hub KPI
      effect: destructive
      questions:
      - How do I delete a KPI from a Customer Insights hub?
      - Can I remove a KPI I no longer track?
      instructions:
      - text: Delete KPI {kpi} from hub {hub} in group {group}.
        slots:
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      - text: Remove the KPI {kpi} in Customer Insights hub {hub} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/kpi/{kpiName}/reprocess'].post
  update:
    x-apievangelist-phrasing:
      intent: Reprocess a KPI's values
      effect: write
      questions:
      - How do I recompute the values of a KPI?
      - Can I force a KPI to be reprocessed after data changes?
      instructions:
      - text: Reprocess KPI {kpi} in hub {hub}, group {group}.
        slots:
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      - text: Recalculate values of KPI {kpi} in {hub} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          kpi: path.kpiName
          hub: path.hubName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/kpi'].get
  update:
    x-apievangelist-phrasing:
      intent: List KPIs in a Customer Insights hub
      effect: read
      questions:
      - What KPIs are defined in my Customer Insights hub?
      - Can I list every KPI for one hub?
      instructions:
      - text: List KPIs in hub {hub}, resource group {group}.
        slots:
          hub: path.hubName
          group: path.resourceGroupName
      - text: Show all KPIs defined in Customer Insights hub {hub} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          hub: path.hubName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'