# 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 Service Fabric Client Repair Management API
  version: 1.0.0
extends: openapi/microsoft-azure-repairmanagement-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['/$/CreateRepairTask'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Service Fabric repair task
      effect: write
      questions:
      - How do I create a repair task on a Service Fabric cluster with Repair Manager?
      - Can a repair task run automatically, or does it need a repair executor?
      instructions:
      - text: Create repair task {repairTask} on the cluster.
        slots:
          repairTask: body.RepairTask
      - text: Create repair task {repairTask} using API version {apiVersion}.
        slots:
          repairTask: body.RepairTask
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/CancelRepairTask'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a repair task
      effect: destructive
      questions:
      - Can I cancel a Service Fabric repair task that hasn't finished?
      - What does a repair task cancellation request need?
      instructions:
      - text: Cancel the repair task described by {cancel}.
        slots:
          cancel: body.RepairTaskCancelDescription
      - text: Request cancellation of repair task {cancel} with API version {apiVersion}.
        slots:
          cancel: body.RepairTaskCancelDescription
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/DeleteRepairTask'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a completed repair task
      effect: destructive
      questions:
      - Can I delete a repair task once it has completed?
      - How do I clean up old finished repair tasks?
      instructions:
      - text: Delete the completed repair task {deleteDescription}.
        slots:
          deleteDescription: body.RepairTaskDeleteDescription
      - text: Remove finished repair task {deleteDescription} using API version {apiVersion}.
        slots:
          deleteDescription: body.RepairTaskDeleteDescription
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/GetRepairTaskList'].get
  update:
    x-apievangelist-phrasing:
      intent: List repair tasks with filters
      effect: read
      questions:
      - Which repair tasks are currently active on my cluster?
      - Can I filter repair tasks by task id prefix, state or executor?
      instructions:
      - text: List repair tasks in state {state}.
        slots:
          state: query.StateFilter
      - text: List repair tasks whose id starts with {taskId} handled by executor {executor}.
        slots:
          taskId: query.TaskIdFilter
          executor: query.ExecutorFilter
      - text: List all repair tasks using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/ForceApproveRepairTask'].post
  update:
    x-apievangelist-phrasing:
      intent: Force-approve a repair task
      effect: write
      questions:
      - Can I force a repair task to be approved without waiting for safety checks?
      - What does force approval of a repair task skip?
      instructions:
      - text: Force approve repair task {approve}.
        slots:
          approve: body.RepairTaskApproveDescription
      - text: Force approval of {approve} with API version {apiVersion}.
        slots:
          approve: body.RepairTaskApproveDescription
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/UpdateRepairTaskHealthPolicy'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a repair task's health policy
      effect: write
      questions:
      - Can I change whether health checks run before or after a repair task?
      - How do I modify the health policy on an existing repair task?
      instructions:
      - text: Update the health policy of repair task {policy}.
        slots:
          policy: body.RepairTaskUpdateHealthPolicyDescription
      - text: Apply health policy change {policy} using API version {apiVersion}.
        slots:
          policy: body.RepairTaskUpdateHealthPolicyDescription
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/UpdateRepairExecutionState'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a repair task's execution state
      effect: write
      questions:
      - How does a repair executor report progress on a repair task?
      - Can I move a repair task to its next execution state?
      instructions:
      - text: Update the execution state of repair task {repairTask}.
        slots:
          repairTask: body.RepairTask
      - text: Report execution progress for {repairTask} with API version {apiVersion}.
        slots:
          repairTask: body.RepairTask
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'