API Evangelist conversational phrasing for Microsoft Azure Azure IoT Central Data Export API

# 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 Azure IoT Central Data Export API
  version: 1.0.0
extends: openapi/microsoft-azure-data-export-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: 12
- target: $.paths['/dataExport/destinations'].get
  update:
    x-apievangelist-phrasing:
      intent: List data export destinations
      effect: read
      questions:
      - Where is my IoT Central application configured to send exported data?
      - What export destinations exist in this application?
      instructions:
      - text: List all data export destinations using API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show every destination set up for continuous data export.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/destinations/{destinationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data export destination
      effect: read
      questions:
      - How do I view the configuration of one export destination?
      - Can I check a destination's status and any delivery errors?
      instructions:
      - text: Get export destination {destinationId}.
        slots:
          destinationId: path.destinationId
      - text: Show the status and errors of destination {destinationId}.
        slots:
          destinationId: path.destinationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/destinations/{destinationId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an export destination
      effect: write
      questions:
      - How do I define a new place to send exported IoT Central data?
      - What do I need to set a destination's type and display name?
      instructions:
      - text: Create export destination {destinationId} named {displayName} of type {type}.
        slots:
          destinationId: path.destinationId
          displayName: requestBody.displayName
          type: requestBody.type
      - text: Replace the full definition of destination {destinationId}.
        slots:
          destinationId: path.destinationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/destinations/{destinationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an export destination
      effect: destructive
      questions:
      - Can I remove a data export destination I no longer use?
      - What happens when I delete a destination that exports still point to?
      instructions:
      - text: Delete export destination {destinationId}.
        slots:
          destinationId: path.destinationId
      - text: Remove the data destination {destinationId} from the app.
        slots:
          destinationId: path.destinationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/destinations/{destinationId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an export destination
      effect: write
      questions:
      - Can I change just one field of an export destination without resending all of it?
      - How do I use an ETag to safely patch a destination?
      instructions:
      - text: Patch destination {destinationId} with only the changed fields.
        slots:
          destinationId: path.destinationId
      - text: Incrementally update destination {destinationId} if its ETag matches {If-Match}.
        slots:
          destinationId: path.destinationId
          If-Match: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/destinations/{destinationId}/exports'].get
  update:
    x-apievangelist-phrasing:
      intent: List exports that use a destination
      effect: read
      questions:
      - Which data exports are sending to this particular destination?
      - Before deleting a destination, how can I see what exports depend on it?
      instructions:
      - text: List exports connected to destination {destinationId}.
        slots:
          destinationId: path.destinationId
      - text: Show which exports feed destination {destinationId}.
        slots:
          destinationId: path.destinationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/exports'].get
  update:
    x-apievangelist-phrasing:
      intent: List data exports
      effect: read
      questions:
      - What continuous data exports are configured in my IoT Central app?
      - Which exports exist in this application right now?
      instructions:
      - text: List all data exports using API version {api-version}.
        slots:
          api-version: query.api-version
      - text: Show every export definition in the application.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/exports/{exportId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data export
      effect: read
      questions:
      - How do I see the source, filter and enrichments of one export?
      - When did a specific export last run and did it error?
      instructions:
      - text: Get data export {exportId}.
        slots:
          exportId: path.exportId
      - text: Show the last export time and errors for export {exportId}.
        slots:
          exportId: path.exportId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/exports/{exportId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a data export
      effect: write
      questions:
      - How do I set up continuous export of telemetry to a destination?
      - Can I connect or disconnect an export from destinations when defining it?
      instructions:
      - text: Create export {exportId} named {displayName} from source {source} to destinations {destinations}.
        slots:
          exportId: path.exportId
          displayName: requestBody.displayName
          source: requestBody.source
          destinations: requestBody.destinations
      - text: Replace export {exportId} and set enabled to {enabled}.
        slots:
          exportId: path.exportId
          enabled: requestBody.enabled
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/exports/{exportId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data export
      effect: destructive
      questions:
      - How do I stop and remove a continuous data export completely?
      - Can I delete an export without deleting its destinations?
      instructions:
      - text: Delete data export {exportId}.
        slots:
          exportId: path.exportId
      - text: Remove the export {exportId} from the app.
        slots:
          exportId: path.exportId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/exports/{exportId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a data export
      effect: write
      questions:
      - Can I pause an export by patching only its enabled flag?
      - How do I make a partial change to an export definition?
      instructions:
      - text: Patch export {exportId} with just the fields that changed.
        slots:
          exportId: path.exportId
      - text: Incrementally update export {exportId} if its ETag is {If-Match}.
        slots:
          exportId: path.exportId
          If-Match: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataExport/exports/{exportId}/destinations'].get
  update:
    x-apievangelist-phrasing:
      intent: List destinations of an export
      effect: read
      questions:
      - Where does one specific export send its data?
      - Which destinations are wired to this export?
      instructions:
      - text: List destinations connected to export {exportId}.
        slots:
          exportId: path.exportId
      - text: Show where export {exportId} delivers data.
        slots:
          exportId: path.exportId
      method: generated
      generated: '2026-10-01'