# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DirectoryObjects Directory Objects.directory Object.Actions…
  version: 1.0.0
extends: openapi/azure-ad-directoryobjects-directoryobject-actions-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: 8
- target: $.paths['/directoryObjects/{directoryObject-id}/microsoft.graph.checkMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Check which of given groups an object belongs to
      effect: read
      questions:
      - How do I check if a user or device is a member of any groups in a list I have?
      - Can I test group membership against specific group IDs in one call?
      instructions:
      - text: Check which of groups {groupIds} directory object {object} is a member of.
        slots:
          groupIds: requestBody.groupIds
          object: path.directoryObject-id
      - text: Tell me whether {object} belongs to any of the groups {groupIds}.
        slots:
          object: path.directoryObject-id
          groupIds: requestBody.groupIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/{directoryObject-id}/microsoft.graph.checkMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Check membership in groups, roles or admin units
      effect: read
      questions:
      - Can I check an object's membership against a mixed list of groups, directory roles and administrative units?
      - Which of these object IDs does a directory object actually belong to?
      instructions:
      - text: Check which of the objects {ids} directory object {object} is a member of.
        slots:
          ids: requestBody.ids
          object: path.directoryObject-id
      - text: Test {object} for membership in the groups, roles or units {ids}.
        slots:
          object: path.directoryObject-id
          ids: requestBody.ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/{directoryObject-id}/microsoft.graph.getMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Get all group IDs an object is a member of
      effect: read
      questions:
      - What are all the group IDs a user, device or service principal belongs to?
      - Can I limit the returned group IDs to security-enabled groups only?
      instructions:
      - text: Get all group IDs directory object {object} is a member of.
        slots:
          object: path.directoryObject-id
      - text: Return group IDs for {object}, security-enabled only set to {securityOnly}.
        slots:
          object: path.directoryObject-id
          securityOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/{directoryObject-id}/microsoft.graph.getMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Get IDs of groups, roles and admin units an object is in
      effect: read
      questions:
      - Which groups, administrative units and directory roles does this object belong to?
      - How do I get every membership ID for a user, including directory roles?
      instructions:
      - text: Get all group, admin unit and directory role IDs for object {object}.
        slots:
          object: path.directoryObject-id
      - text: List membership object IDs for {object}, security-enabled groups only set to {securityOnly}.
        slots:
          object: path.directoryObject-id
          securityOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/{directoryObject-id}/microsoft.graph.restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a recently deleted directory object
      effect: write
      questions:
      - How do I bring back an app, group or user that was deleted recently?
      - Can I recover a directory object from deleted items?
      instructions:
      - text: Restore deleted directory object {object}.
        slots:
          object: path.directoryObject-id
      - text: Recover {object} from deleted items.
        slots:
          object: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/microsoft.graph.getAvailableExtensionProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: List all directory extension definitions in the tenant
      effect: read
      questions:
      - Which directory extensions are registered in our tenant, including from multitenant apps?
      - Can I see only the extension properties synced from on-premises?
      instructions:
      - text: List all directory extension properties available in the tenant.
      - text: Show available extension properties with synced-from-on-premises set to {synced}.
        slots:
          synced: requestBody.isSyncedFromOnPremises
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/microsoft.graph.getByIds'].post
  update:
    x-apievangelist-phrasing:
      intent: Get multiple directory objects by their IDs
      effect: read
      questions:
      - How do I resolve a batch of object IDs to users, groups and devices in one request?
      - Can I restrict a bulk ID lookup to certain object types?
      instructions:
      - text: Get the directory objects with IDs {ids}.
        slots:
          ids: requestBody.ids
      - text: Resolve IDs {ids} limited to object types {types}.
        slots:
          ids: requestBody.ids
          types: requestBody.types
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryObjects/microsoft.graph.validateProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a group name against naming policy
      effect: read
      questions:
      - Will a Microsoft 365 group display name pass our naming policy before I create it?
      - Can I check if a mail nickname contains blocked words?
      instructions:
      - text: Validate group display name {displayName} and mail nickname {mailNickname} against naming policy.
        slots:
          displayName: requestBody.displayName
          mailNickname: requestBody.mailNickname
      - text: Check whether display name {displayName} complies with naming policy on behalf of user {user}.
        slots:
          displayName: requestBody.displayName
          user: requestBody.onBehalfOfUserId
      method: generated
      generated: '2026-10-01'