# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Groups Group Lifecycle Policies.group Lifecycle Policy API
  version: 1.0.0
extends: openapi/azure-ad-grouplifecyclepolicies-grouplifecyclepolicy-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: 6
- target: $.paths['/groupLifecyclePolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List group expiration policies
      effect: read
      questions:
      - Do we have a group expiration policy set up in our tenant?
      - How do I see the group lifecycle policy and its settings?
      instructions:
      - text: List the group lifecycle policies.
      - text: Show all group expiration policies in the tenant.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupLifecyclePolicies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a group expiration policy
      effect: write
      questions:
      - How do I make Microsoft 365 groups expire automatically after a set number of days?
      - Who gets notified about expiring groups that have no owner?
      instructions:
      - text: Create a group lifecycle policy that expires groups after {groupLifetimeInDays} days.
        slots:
          groupLifetimeInDays: requestBody.groupLifetimeInDays
      - text: Set up group expiration for {managedGroupTypes} groups, notifying {alternateNotificationEmails} when there's no owner.
        slots:
          managedGroupTypes: requestBody.managedGroupTypes
          alternateNotificationEmails: requestBody.alternateNotificationEmails
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupLifecyclePolicies/{groupLifecyclePolicy-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group expiration policy
      effect: read
      questions:
      - What lifetime in days does a specific group lifecycle policy use?
      - How do I read one group expiration policy by ID?
      instructions:
      - text: Get group lifecycle policy {policy}.
        slots:
          policy: path.groupLifecyclePolicy-id
      - text: Show the expiration settings of policy {policy}.
        slots:
          policy: path.groupLifecyclePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupLifecyclePolicies/{groupLifecyclePolicy-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a group expiration policy
      effect: destructive
      questions:
      - How do I turn off group expiration for the tenant?
      - Can I delete the group lifecycle policy by ID?
      instructions:
      - text: Delete group lifecycle policy {policy}.
        slots:
          policy: path.groupLifecyclePolicy-id
      - text: Remove expiration policy {policy} so groups no longer expire.
        slots:
          policy: path.groupLifecyclePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupLifecyclePolicies/{groupLifecyclePolicy-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a group expiration policy
      effect: write
      questions:
      - How do I change how many days groups live before they expire?
      - Can I change which groups the expiration policy applies to, or its notification emails?
      instructions:
      - text: Change group lifetime on policy {policy} to {groupLifetimeInDays} days.
        slots:
          policy: path.groupLifecyclePolicy-id
          groupLifetimeInDays: requestBody.groupLifetimeInDays
      - text: Apply expiration policy {policy} to {managedGroupTypes} groups.
        slots:
          policy: path.groupLifecyclePolicy-id
          managedGroupTypes: requestBody.managedGroupTypes
      - text: Send ownerless-group expiry notices for policy {policy} to {alternateNotificationEmails}.
        slots:
          policy: path.groupLifecyclePolicy-id
          alternateNotificationEmails: requestBody.alternateNotificationEmails
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupLifecyclePolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count group expiration policies
      effect: read
      questions:
      - How many group lifecycle policies exist in the tenant?
      - What's the count of group expiration policies?
      instructions:
      - text: Count the group lifecycle policies.
      - text: Tell me how many group expiration policies are defined.
      method: generated
      generated: '2026-10-01'