ControlUp · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DaaS IQ Host pool deployments API

2 actions 2 updates phrasing extends openapi/controlup-host-pool-deployments-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for ControlUp's API. It is a proposal applied on top of the contract, not a document ControlUp publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 2

$.info
$.paths['/cloud/subscriptions/{subscriptionId}/host-pool-deployments'].post

OpenAPI Overlay

Raw ↑
# 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'