# 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 Defender EASM Data Connections API
  version: 1.0.0
extends: openapi/microsoft-azure-data-connections-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['/dataConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List data connections
      effect: read
      questions:
      - Which data connections are sending my attack surface data out?
      - Can I page through data connections with a page size?
      instructions:
      - text: List all data connections.
      - text: List {maxpagesize} data connections starting after {skip}.
        slots:
          maxpagesize: query.maxpagesize
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataConnections/{dataConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data connection
      effect: read
      questions:
      - How do I view the settings of one data connection?
      - What frequency is a given data connection exporting at?
      instructions:
      - text: Get data connection {dataConnectionName}.
        slots:
          dataConnectionName: path.dataConnectionName
      - text: Show the export schedule of data connection {dataConnectionName}.
        slots:
          dataConnectionName: path.dataConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataConnections/{dataConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a data connection
      effect: write
      questions:
      - How do I set up a data connection to export assets to Log Analytics or Data Explorer?
      - Can I choose which content and how often a data connection sends?
      instructions:
      - text: Create data connection {dataConnectionName} of kind {kind}.
        slots:
          dataConnectionName: path.dataConnectionName
          kind: requestBody.kind
      - text: Replace data connection {dataConnectionName} to send {content} every {frequency}.
        slots:
          dataConnectionName: path.dataConnectionName
          content: requestBody.content
          frequency: requestBody.frequency
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataConnections/{dataConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data connection
      effect: destructive
      questions:
      - How do I stop and remove a data connection?
      - Can I delete a data connection by name?
      instructions:
      - text: Delete data connection {dataConnectionName}.
        slots:
          dataConnectionName: path.dataConnectionName
      - text: Remove the export connection {dataConnectionName}.
        slots:
          dataConnectionName: path.dataConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/dataConnections:validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a data connection before saving
      effect: read
      questions:
      - Can I test a data connection's settings without creating it?
      - Is there a dry-run check for a new data connection configuration?
      instructions:
      - text: Validate a data connection of kind {kind}.
        slots:
          kind: requestBody.kind
      - text: Check data connection {name} with content {content} before saving.
        slots:
          name: requestBody.name
          content: requestBody.content
      method: generated
      generated: '2026-09-26'