# 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 TimeSeriesInsightsClient Reference Data…
  version: 1.0.0
extends: openapi/microsoft-azure-reference-data-sets-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/referenceDataSets/{referenceDataSetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Time Series Insights reference data set
      effect: read
      questions:
      - What's in a specific reference data set of my Time Series Insights environment?
      - Can I look up a reference data set by name?
      instructions:
      - text: Get reference data set {referenceDataSetName} in environment {environmentName}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
      - text: Show reference data {referenceDataSetName} of {environmentName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/referenceDataSets/{referenceDataSetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a reference data set
      effect: write
      questions:
      - How do I add a reference data set to enrich my Time Series Insights events?
      - Can I redefine the key properties of an existing reference data set?
      instructions:
      - text: Create reference data set {referenceDataSetName} in environment {environmentName} at {location}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
          location: requestBody.location
      - text: Create or update {referenceDataSetName} in {environmentName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/referenceDataSets/{referenceDataSetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a reference data set
      effect: destructive
      questions:
      - Can I delete a reference data set from a Time Series Insights environment?
      - Is there a way to remove reference data I no longer need?
      instructions:
      - text: Delete reference data set {referenceDataSetName} from environment {environmentName}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
      - text: Remove {referenceDataSetName} from {environmentName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/referenceDataSets/{referenceDataSetName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a reference data set's tags
      effect: write
      questions:
      - Can I change only the tags on a reference data set?
      - How do I retag a reference data set without recreating it?
      instructions:
      - text: Update tags on reference data set {referenceDataSetName} in environment {environmentName}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
      - text: Retag {referenceDataSetName} in {environmentName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          referenceDataSetName: path.referenceDataSetName
          environmentName: path.environmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/referenceDataSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List reference data sets in an environment
      effect: read
      questions:
      - Which reference data sets exist in my Time Series Insights environment?
      - Can I list all reference data for one environment?
      instructions:
      - text: List reference data sets in environment {environmentName}.
        slots:
          environmentName: path.environmentName
      - text: Show every reference data set of {environmentName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          environmentName: path.environmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'