# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.SignIns Policies.ownerless Group Policy API
  version: 1.0.0
extends: openapi/azure-ad-policies-ownerlessgrouppolicy-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/policies/ownerlessGroupPolicy'].get
  update:
    x-apievangelist-phrasing:
      intent: View the tenant's ownerless group policy
      effect: read
      questions:
      - What is our current policy for Microsoft 365 groups that have no owner?
      - Is the ownerless group policy turned on in my tenant, and how often does it notify members?
      instructions:
      - text: Show the ownerless group policy settings.
      - text: Read the tenant's ownerless group policy with only {select}.
        slots:
          select: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/ownerlessGroupPolicy'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update the ownerless group policy
      effect: write
      questions:
      - How do I set up notifications asking members to take ownership of groups that lost their owner?
      - Can I limit how many members get notified when a group becomes ownerless?
      - Is it possible to apply the ownerless group policy to only certain groups?
      instructions:
      - text: Turn the ownerless group policy {isEnabled}.
        slots:
          isEnabled: requestBody.isEnabled
      - text: Notify up to {maxMembersToNotify} members for {notificationDurationInWeeks} weeks when a group has no owner.
        slots:
          maxMembersToNotify: requestBody.maxMembersToNotify
          notificationDurationInWeeks: requestBody.notificationDurationInWeeks
      - text: Apply the ownerless group policy only to groups {enabledGroupIds}.
        slots:
          enabledGroupIds: requestBody.enabledGroupIds
      method: generated
      generated: '2026-10-01'