# 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 Migrate Assessment Service Web App…
  version: 1.0.0
extends: openapi/microsoft-azure-webappassessmentv2operations-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/webAppAssessments'].get
  update:
    x-apievangelist-phrasing:
      intent: List web app assessments in a migration group
      effect: read
      questions:
      - Which web app migration assessments exist for a group in Azure Migrate?
      - Can I see all web app assessments in one assessment project group?
      instructions:
      - text: List web app assessments for group {groupName} in project {projectName}.
        slots:
          groupName: path.groupName
          projectName: path.projectName
      - text: Show the web app assessments under {groupName}.
        slots:
          groupName: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/webAppAssessments/{assessmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app assessment
      effect: read
      questions:
      - What did a specific web app assessment conclude about migration readiness?
      - Can I look up one web app assessment by name?
      instructions:
      - text: Get web app assessment {assessmentName} in group {groupName} of project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Show the results of web app assessment {assessmentName}.
        slots:
          assessmentName: path.assessmentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/webAppAssessments/{assessmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a web app assessment
      effect: write
      questions:
      - How do I assess web apps in a group for migration to Azure?
      - Can I create a new web app assessment with custom settings?
      instructions:
      - text: Create web app assessment {assessmentName} for group {groupName} in project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Run a new web app assessment called {assessmentName} on {groupName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/webAppAssessments/{assessmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a web app assessment
      effect: destructive
      questions:
      - Can I delete an outdated web app assessment?
      - Is a deleted web app assessment recoverable?
      instructions:
      - text: Delete web app assessment {assessmentName} from group {groupName} in project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Remove web app assessment {assessmentName}.
        slots:
          assessmentName: path.assessmentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/webAppAssessments/{assessmentName}/downloadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a download link for a web app assessment report
      effect: read
      questions:
      - Where can I download a web app assessment as a report?
      - Can I export a web app assessment to share with my team?
      instructions:
      - text: Get the report download URL for web app assessment {assessmentName} in group {groupName} of project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Give me a download link for assessment report {assessmentName}.
        slots:
          assessmentName: path.assessmentName
      method: generated
      generated: '2026-09-26'