# 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 User API
  version: 1.0.0
extends: openapi/microsoft-azure-user-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: 6
- target: $.paths['/{tenantID}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List users in a directory tenant
      effect: read
      questions:
      - How do I list the users in my Azure AD tenant?
      - Can I filter directory users or limit how many come back?
      instructions:
      - text: List users in tenant {tenantID}.
        slots:
          tenantID: path.tenantID
      - text: List users in tenant {tenantID} matching {filter}, top {top}.
        slots:
          tenantID: path.tenantID
          filter: query.$filter
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a directory user
      effect: write
      questions:
      - How do I add a new user account to my Azure AD tenant?
      - Which fields are required when creating a directory user?
      instructions:
      - text: Create user {userPrincipalName} ({displayName}, nickname {mailNickname}) in tenant {tenantID}, enabled {accountEnabled}, password {passwordProfile}.
        slots:
          userPrincipalName: requestBody.userPrincipalName
          displayName: requestBody.displayName
          mailNickname: requestBody.mailNickname
          tenantID: path.tenantID
          accountEnabled: requestBody.accountEnabled
          passwordProfile: requestBody.passwordProfile
      - text: Add {displayName} as a new directory user in tenant {tenantID}.
        slots:
          displayName: requestBody.displayName
          tenantID: path.tenantID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/users/{upnOrObjectId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a directory user
      effect: read
      questions:
      - How do I look up a user by UPN or object ID?
      - What profile details does the directory return for one user?
      instructions:
      - text: Get user {upnOrObjectId} in tenant {tenantID}.
        slots:
          upnOrObjectId: path.upnOrObjectId
          tenantID: path.tenantID
      - text: Show the directory profile of {upnOrObjectId}.
        slots:
          upnOrObjectId: path.upnOrObjectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/users/{upnOrObjectId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a directory user
      effect: destructive
      questions:
      - Can I delete a user account from my tenant?
      - How do I remove someone from the directory by UPN?
      instructions:
      - text: Delete user {upnOrObjectId} from tenant {tenantID}.
        slots:
          upnOrObjectId: path.upnOrObjectId
          tenantID: path.tenantID
      - text: Remove directory user {upnOrObjectId}.
        slots:
          upnOrObjectId: path.upnOrObjectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/users/{upnOrObjectId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a directory user
      effect: write
      questions:
      - How do I change a user's display name or usage location?
      - Can I disable a user account by updating it?
      instructions:
      - text: Update user {upnOrObjectId} in tenant {tenantID} with display name {displayName}.
        slots:
          upnOrObjectId: path.upnOrObjectId
          tenantID: path.tenantID
          displayName: requestBody.displayName
      - text: Set accountEnabled to {accountEnabled} for user {upnOrObjectId}.
        slots:
          accountEnabled: requestBody.accountEnabled
          upnOrObjectId: path.upnOrObjectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{tenantID}/users/{objectId}/getMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the groups a user belongs to
      effect: read
      questions:
      - Which groups is this user a member of?
      - Can I return only security-enabled groups for a user?
      instructions:
      - text: Get the group IDs user {objectId} belongs to in tenant {tenantID}, security-only {securityEnabledOnly}.
        slots:
          objectId: path.objectId
          tenantID: path.tenantID
          securityEnabledOnly: requestBody.securityEnabledOnly
      - text: List only the security groups that user {objectId} is a member of, security-only {securityEnabledOnly}.
        slots:
          objectId: path.objectId
          securityEnabledOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-09-26'