# 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 Labels API
  version: 1.0.0
extends: openapi/microsoft-azure-labels-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: 7
- target: $.paths['/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List labels in an App Configuration store
      effect: read
      questions:
      - Which labels are used on the key-values in my App Configuration store?
      - Can I filter configuration labels by name or see them as they were at an earlier time?
      - How do I page through labels after a continuation token?
      instructions:
      - text: List the labels in my App Configuration store.
      - text: List configuration labels whose name matches {name}.
        slots:
          name: query.name
      - text: Show the labels as they existed at {AcceptDatetime}.
        slots:
          AcceptDatetime: header.Accept-Datetime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/labels'].head
  update:
    x-apievangelist-phrasing:
      intent: Check App Configuration labels headers only
      effect: read
      questions:
      - Can I check whether configuration labels exist without downloading the list?
      - Is there a HEAD request that returns just the headers for the labels collection?
      instructions:
      - text: Send a HEAD request for configuration labels matching {name}.
        slots:
          name: query.name
      - text: Check the labels endpoint headers without fetching the label list body.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List labels in a Defender EASM workspace
      effect: read
      questions:
      - Which labels have been defined in my Defender External Attack Surface Management workspace?
      - Can I see all the asset labels in an EASM workspace?
      instructions:
      - text: List the labels in EASM workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show every asset label defined in attack surface workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}/labels/{labelName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a label in a Defender EASM workspace
      effect: read
      questions:
      - What are the properties of a specific label in my EASM workspace?
      - Can I look up one attack surface label by its name?
      instructions:
      - text: Get label {labelName} from EASM workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      - text: Show the details of attack surface label {labelName} in workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}/labels/{labelName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a label in a Defender EASM workspace
      effect: write
      questions:
      - What does it take to create a new label for tagging assets in my EASM workspace?
      - Can I overwrite an existing attack surface label with a full PUT?
      instructions:
      - text: Create label {labelName} in EASM workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      - text: Create or replace attack surface label {labelName} in workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}/labels/{labelName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a label from a Defender EASM workspace
      effect: destructive
      questions:
      - Can I delete a label I no longer use from my EASM workspace?
      - What happens when I remove an attack surface label from a workspace?
      instructions:
      - text: Delete label {labelName} from EASM workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      - text: Remove attack surface label {labelName} from workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Easm/workspaces/{workspaceName}/labels/{labelName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a label in a Defender EASM workspace
      effect: write
      questions:
      - Can I change just some properties of an existing EASM label with a PATCH?
      - Is it possible to rename or recolor an attack surface label after it is created?
      instructions:
      - text: Patch the properties of existing label {labelName} in EASM workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      - text: Partially update attack surface label {labelName} in workspace {workspaceName}.
        slots:
          labelName: path.labelName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'