# 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 Management Groups API
  version: 1.0.0
extends: openapi/microsoft-azure-managementgroups-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['/providers/Microsoft.Management/managementGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List my management groups
      effect: read
      questions:
      - Which Azure management groups can I see as the signed-in user?
      - Can I page through management groups with a skip token?
      instructions:
      - text: List all management groups I have access to.
      - text: Show the next page of management groups after {skiptoken}.
        slots:
          skiptoken: query.$skiptoken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a management group's details
      effect: read
      questions:
      - What are the details and children of a specific management group?
      - Can I expand a management group to include its whole descendant hierarchy?
      instructions:
      - text: Get management group {groupId}.
        slots:
          groupId: path.groupId
      - text: 'Show management group {groupId} expanded with {expand}, recursing into descendants: {recurse}.'
        slots:
          groupId: path.groupId
          expand: query.$expand
          recurse: query.$recurse
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a management group
      effect: write
      questions:
      - How do I create a new management group in my Azure tenant?
      - What happens if I send a create request for a management group that already exists?
      instructions:
      - text: Create management group {groupId}.
        slots:
          groupId: path.groupId
      - text: Create or overwrite management group {groupId} using {createManagementGroupRequest}.
        slots:
          groupId: path.groupId
          createManagementGroupRequest: body.createManagementGroupRequest
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a management group
      effect: destructive
      questions:
      - How do I delete a management group?
      - Why would deleting a management group fail if it still has children?
      instructions:
      - text: Delete management group {groupId}.
        slots:
          groupId: path.groupId
      - text: Remove the empty management group {groupId}.
        slots:
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a management group
      effect: write
      questions:
      - Can I rename or re-parent an existing management group with a patch?
      - Is there a way to change only some fields of a management group?
      instructions:
      - text: Patch management group {groupId} with {patchGroupRequest}.
        slots:
          groupId: path.groupId
          patchGroupRequest: body.patchGroupRequest
      - text: Update the display name or parent of existing management group {groupId}.
        slots:
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Move a subscription into a management group
      effect: write
      questions:
      - How do I put an existing subscription under a management group?
      - Can I associate a subscription with a different management group?
      instructions:
      - text: Associate subscription {subscriptionId} with management group {groupId}.
        slots:
          subscriptionId: path.subscriptionId
          groupId: path.groupId
      - text: Move subscription {subscriptionId} under management group {groupId}.
        slots:
          subscriptionId: path.subscriptionId
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Management/managementGroups/{groupId}/subscriptions/{subscriptionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a subscription from a management group
      effect: destructive
      questions:
      - How do I take a subscription out of a management group?
      - Can I de-associate a subscription from its management group?
      instructions:
      - text: Remove subscription {subscriptionId} from management group {groupId}.
        slots:
          subscriptionId: path.subscriptionId
          groupId: path.groupId
      - text: De-associate subscription {subscriptionId} from group {groupId}.
        slots:
          subscriptionId: path.subscriptionId
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'