# 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 GraphRbacManagementClient Groups Owners API
  version: 1.0.0
extends: openapi/microsoft-azure-groupsowners-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: 2
- target: $.paths['/{tenantID}/groups/{objectId}/$links/owners'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an owner to a directory group
      effect: write
      questions:
      - Can I make a user an owner of an Azure AD group?
      - What do I pass to add a new owner to a group in my tenant?
      instructions:
      - text: Add the object at {url} as an owner of group {group} in tenant {tenant}.
        slots:
          url: requestBody.url
          group: path.objectId
          tenant: path.tenantID
      - text: Make {url} an owner of group {group}.
        slots:
          url: requestBody.url
          group: path.objectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/groups/{objectId}/$links/owners/{ownerObjectId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an owner from a directory group
      effect: destructive
      questions:
      - Can I remove someone as an owner of an Azure AD group?
      - Is there a way to take away a user's group ownership?
      instructions:
      - text: Remove owner {owner} from group {group} in tenant {tenant}.
        slots:
          owner: path.ownerObjectId
          group: path.objectId
          tenant: path.tenantID
      - text: Take {owner} off the owners of group {group}.
        slots:
          owner: path.ownerObjectId
          group: path.objectId
      method: generated
      generated: '2026-09-26'