# 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 DataPlaneAccountClient Contact Group…
  version: 1.0.0
extends: openapi/microsoft-azure-contactgroupdefinition-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: 4
- target: $.paths['/contactGroupDefinitions/{contactGroupDefinitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a contact group definition
      effect: read
      questions:
      - How do I look up one contact group definition by name?
      - What type and friendly name does a contact group definition have?
      instructions:
      - text: Get contact group definition {definition}.
        slots:
          definition: path.contactGroupDefinitionName
      - text: Show details of contact group definition {definition}.
        slots:
          definition: path.contactGroupDefinitionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contactGroupDefinitions/{contactGroupDefinitionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a contact group definition
      effect: write
      questions:
      - How do I define a new contact group?
      - Can I change the friendly name or description of a contact group definition?
      instructions:
      - text: Create contact group definition {definition} of type {type} named {friendly_name}.
        slots:
          definition: path.contactGroupDefinitionName
          type: requestBody.contactGroupType
          friendly_name: requestBody.friendlyName
      - text: Update the description of contact group definition {definition} to {description}.
        slots:
          definition: path.contactGroupDefinitionName
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contactGroupDefinitions/{contactGroupDefinitionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a contact group definition
      effect: destructive
      questions:
      - Can I delete a contact group definition I no longer use?
      - Is removing a contact group definition reversible?
      instructions:
      - text: Delete contact group definition {definition}.
        slots:
          definition: path.contactGroupDefinitionName
      - text: Remove the contact group definition named {definition}.
        slots:
          definition: path.contactGroupDefinitionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/contactGroupDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List contact group definitions in the account
      effect: read
      questions:
      - Which contact group definitions exist in my account?
      - How do I page through all contact group definitions?
      instructions:
      - text: List all contact group definitions.
      - text: Show the next page of contact group definitions from token {skip_token}.
        slots:
          skip_token: query.$skipToken
      method: generated
      generated: '2026-09-26'