# 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 Connector…
  version: 1.0.0
extends: openapi/microsoft-azure-connectormappings-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/connectors/{connectorName}/mappings/{mappingName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Customer Insights connector mapping
      effect: read
      questions:
      - How do I view how a connector maps incoming data in a Customer Insights hub?
      - What entity does a given connector mapping load into?
      instructions:
      - text: Get mapping {mappingName} of connector {connectorName} in hub {hubName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          mappingName: path.mappingName
          connectorName: path.connectorName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show connector mapping {mappingName} on {connectorName}.
        slots:
          mappingName: path.mappingName
          connectorName: path.connectorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/connectors/{connectorName}/mappings/{mappingName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a connector mapping
      effect: write
      questions:
      - How do I map a connector's data into a profile or interaction in Customer Insights?
      - Can I change an existing connector mapping's definition?
      instructions:
      - text: Create mapping {mappingName} on connector {connectorName} in hub {hubName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          mappingName: path.mappingName
          connectorName: path.connectorName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Set mapping {mappingName} on {connectorName} to definition {properties}.
        slots:
          mappingName: path.mappingName
          connectorName: path.connectorName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/connectors/{connectorName}/mappings/{mappingName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a connector mapping
      effect: destructive
      questions:
      - How do I remove a mapping from a Customer Insights connector?
      - Will deleting a connector mapping stop that data from loading?
      instructions:
      - text: Delete mapping {mappingName} from connector {connectorName} in hub {hubName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          mappingName: path.mappingName
          connectorName: path.connectorName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove connector mapping {mappingName} on {connectorName}.
        slots:
          mappingName: path.mappingName
          connectorName: path.connectorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/connectors/{connectorName}/mappings'].get
  update:
    x-apievangelist-phrasing:
      intent: List mappings for a connector
      effect: read
      questions:
      - Which mappings are defined on a Customer Insights connector?
      - How many data mappings does my connector have?
      instructions:
      - text: List mappings on connector {connectorName} in hub {hubName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          connectorName: path.connectorName
          hubName: path.hubName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show all mappings of connector {connectorName}.
        slots:
          connectorName: path.connectorName
      method: generated
      generated: '2026-09-26'