# 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 AutomationManagement Watcher API
  version: 1.0.0
extends: openapi/microsoft-azure-watcher-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers/{watcherName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Automation watcher
      effect: read
      questions:
      - How do I look up a watcher task in my Azure Automation account?
      - What runbook and schedule does a given watcher use?
      instructions:
      - text: Get watcher {watcher} in Automation account {account}.
        slots:
          watcher: path.watcherName
          account: path.automationAccountName
      - text: Show the settings of watcher {watcher}.
        slots:
          watcher: path.watcherName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers/{watcherName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Automation watcher
      effect: write
      questions:
      - How do I create a watcher in Azure Automation to run a runbook on a schedule?
      - What properties do I set when creating a new Automation watcher?
      instructions:
      - text: Create watcher {watcher} in Automation account {account} with properties {properties}.
        slots:
          watcher: path.watcherName
          account: path.automationAccountName
          properties: requestBody.properties
      - text: Add a new watcher named {watcher} in {location}.
        slots:
          watcher: path.watcherName
          location: requestBody.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers/{watcherName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Automation watcher
      effect: destructive
      questions:
      - How do I remove a watcher from my Automation account?
      - Can I delete a watcher I no longer need?
      instructions:
      - text: Delete watcher {watcher} from Automation account {account}.
        slots:
          watcher: path.watcherName
          account: path.automationAccountName
      - text: Remove watcher {watcher} from the Automation account.
        slots:
          watcher: path.watcherName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers/{watcherName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Automation watcher
      effect: write
      questions:
      - Can I change the properties of an existing Automation watcher?
      - How do I modify a watcher's execution frequency after creating it?
      instructions:
      - text: Update existing watcher {watcher} in Automation account {account} with properties {properties}.
        slots:
          watcher: path.watcherName
          account: path.automationAccountName
          properties: requestBody.properties
      - text: Change the settings of existing watcher {watcher}.
        slots:
          watcher: path.watcherName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers/{watcherName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an Automation watcher
      effect: write
      questions:
      - How do I resume a stopped watcher in Azure Automation?
      - Can I start a watcher so it begins running again?
      instructions:
      - text: Start watcher {watcher} in Automation account {account}.
        slots:
          watcher: path.watcherName
          account: path.automationAccountName
      - text: Resume watcher {watcher}.
        slots:
          watcher: path.watcherName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers/{watcherName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an Automation watcher
      effect: write
      questions:
      - How do I stop a running watcher in Azure Automation?
      - Can I pause a watcher without deleting it?
      instructions:
      - text: Stop watcher {watcher} in Automation account {account}.
        slots:
          watcher: path.watcherName
          account: path.automationAccountName
      - text: Pause watcher {watcher} without removing it.
        slots:
          watcher: path.watcherName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/watchers'].get
  update:
    x-apievangelist-phrasing:
      intent: List watchers in an Automation account
      effect: read
      questions:
      - Which watchers exist in my Azure Automation account?
      - Can I filter the list of Automation watchers?
      instructions:
      - text: List all watchers in Automation account {account}.
        slots:
          account: path.automationAccountName
      - text: List Automation watchers matching filter {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'