# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DaaS IQ Host pool deployments API
  version: 1.0.0
extends: openapi/controlup-host-pool-deployments-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: 1
- target: $.paths['/cloud/subscriptions/{subscriptionId}/host-pool-deployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Deploy a new AVD host pool
      effect: write
      questions:
      - Can I deploy a new Azure Virtual Desktop host pool with its app group and workspace in one job?
      - What settings do I need to create a pooled host pool with a max session limit?
      instructions:
      - text: Deploy {hostPoolType} pool {name} to {subscriptionId}/{resourceGroupName} in {region}, {appGroupType} app group, workspace {workspaceResourceId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
          resourceGroupName: requestBody.resourceGroupName
          region: requestBody.region
          hostPoolType: requestBody.hostPoolType
          appGroupType: requestBody.appGroupType
          workspaceResourceId: requestBody.workspaceResourceId
      - text: Create AVD host pool {name} in subscription {subscriptionId} with {initialHostCount} initial hosts.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
          initialHostCount: requestBody.initialHostCount
      method: generated
      generated: '2026-09-26'