API Evangelist conversational phrasing for Identity.DirectoryManagement Directory.directory Object API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.DirectoryManagement Directory.directory Object API
  version: 1.0.0
extends: openapi/azure-ad-directory-directoryobject-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: 30
- target: $.paths['/directory/deletedItems'].get
  update:
    x-apievangelist-phrasing:
      intent: List recently deleted directory objects
      effect: read
      questions:
      - What directory objects have been deleted recently in my Entra tenant?
      - Can I search the deleted items bin across every object type at once?
      instructions:
      - text: List everything currently sitting in the directory's deleted items.
      - text: Search all deleted directory objects for {term}.
        slots:
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted directory object
      effect: read
      questions:
      - What did a soft-deleted directory object look like before it was removed?
      - Can I look up one deleted object by ID without knowing whether it was a user or a group?
      instructions:
      - text: Show deleted directory object {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Fetch the properties of recently deleted item {object_id} regardless of its type.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete an object from deleted items
      effect: destructive
      questions:
      - How do I purge something from deleted items so it can never be restored?
      - Can I hard-delete a soft-deleted application right now?
      instructions:
      - text: Permanently delete {object_id} from deleted items.
        slots:
          object_id: path.directoryObject-id
      - text: Purge soft-deleted object {object_id} for good so nobody can bring it back.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted administrative unit
      effect: read
      questions:
      - What were the settings of an administrative unit someone removed?
      - Can I read a deleted item typed as an administrative unit?
      instructions:
      - text: Show the removed administrative unit {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Get deleted item {object_id} cast as an administrative unit.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted app registration
      effect: read
      questions:
      - What was configured on an app registration that got deleted?
      - Can I see the application properties of one soft-deleted app before restoring it?
      instructions:
      - text: Show the deleted app registration {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Get deleted item {object_id} as an application object.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.checkMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a deleted object's membership in given groups
      effect: read
      questions:
      - Which of a handful of groups was a deleted object a member of?
      - Can I test a soft-deleted object against a specific list of group IDs?
      instructions:
      - text: Check whether deleted object {object_id} belongs to any of the groups {group_ids}.
        slots:
          object_id: path.directoryObject-id
          group_ids: requestBody.groupIds
      - text: 'Tell me which of these groups deleted item {object_id} was in: {group_ids}.'
        slots:
          object_id: path.directoryObject-id
          group_ids: requestBody.groupIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.checkMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a deleted object against directory object IDs
      effect: read
      questions:
      - Was a deleted object a member of certain groups, admin units or directory roles?
      - Can I check a deleted item against a mixed list of object IDs, not just groups?
      instructions:
      - text: Check deleted object {object_id} for membership in the objects {ids}.
        slots:
          object_id: path.directoryObject-id
          ids: requestBody.ids
      - text: Run checkMemberObjects on deleted item {object_id}.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted device
      effect: read
      questions:
      - What do I know about a device record that was removed from the directory?
      - Can I read a soft-deleted item as a device object?
      instructions:
      - text: Show the deleted device {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Get deleted item {object_id} cast as a device.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.getMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: List every group a deleted object belonged to
      effect: read
      questions:
      - What groups was a deleted user or service principal a member of?
      - Can I limit a deleted object's group memberships to security groups only?
      instructions:
      - text: Get all group IDs that deleted object {object_id} is a member of.
        slots:
          object_id: path.directoryObject-id
      - text: List groups for deleted item {object_id} with security-enabled only set to {security_only}.
        slots:
          object_id: path.directoryObject-id
          security_only: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.getMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: List groups, admin units and roles of a deleted object
      effect: read
      questions:
      - Which groups, administrative units and directory roles did a deleted object hold?
      - Can I recover a full membership picture for a soft-deleted account before restoring it?
      instructions:
      - text: Get the member objects of deleted item {object_id}, including admin units and directory roles.
        slots:
          object_id: path.directoryObject-id
      - text: List memberships of deleted object {object_id} with security-enabled only {security_only}.
        slots:
          object_id: path.directoryObject-id
          security_only: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted group
      effect: read
      questions:
      - What were the details of a Microsoft 365 or security group that was deleted?
      - Can I read a soft-deleted item as a group object?
      instructions:
      - text: Show the deleted group {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Get deleted item {object_id} cast as a group.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a deleted directory object
      effect: write
      questions:
      - How do I undelete a user or group that was removed by mistake?
      - Can I bring back an app registration from deleted items?
      instructions:
      - text: Restore deleted object {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Undo the deletion of {object_id} and put it back in the directory.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted service principal
      effect: read
      questions:
      - What was set on an enterprise app's service principal that got deleted?
      - Can I read a soft-deleted item as a service principal?
      instructions:
      - text: Show the deleted service principal {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Get deleted item {object_id} cast as a service principal.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deleted user
      effect: read
      questions:
      - What were the account details of an employee who was deleted?
      - Can I read a soft-deleted item as a user object?
      instructions:
      - text: Show the deleted user {object_id}.
        slots:
          object_id: path.directoryObject-id
      - text: Get deleted item {object_id} cast as a user.
        slots:
          object_id: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all deleted directory objects
      effect: read
      questions:
      - How many objects of any kind are in the deleted items bin?
      - What's the total number of soft-deleted objects matching a filter?
      instructions:
      - text: Count all deleted directory objects.
      - text: Count deleted items that match {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted administrative units
      effect: read
      questions:
      - Which administrative units have been deleted lately?
      - Can I see only the administrative units in the recycle bin?
      instructions:
      - text: List deleted administrative units.
      - text: Find deleted administrative units named like {term}.
        slots:
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count deleted administrative units
      effect: read
      questions:
      - How many administrative units are waiting in deleted items?
      - What number of removed admin units match a given filter?
      instructions:
      - text: Count the deleted administrative units.
      - text: Count deleted admin units matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted app registrations
      effect: read
      questions:
      - Which app registrations were deleted and can still be restored?
      - Can I filter the deleted applications by display name?
      instructions:
      - text: List deleted app registrations.
      - text: Show deleted applications matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.application/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count deleted app registrations
      effect: read
      questions:
      - How many app registrations are sitting in deleted items?
      - What's the count of soft-deleted applications that match a search?
      instructions:
      - text: Count the deleted applications.
      - text: Count deleted app registrations that match {term}.
        slots:
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted devices
      effect: read
      questions:
      - Which device records have been removed from the directory recently?
      - Can I narrow the deleted devices down with a filter?
      instructions:
      - text: List deleted devices.
      - text: Show deleted devices matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.device/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count deleted devices
      effect: read
      questions:
      - How many devices are in the deleted items bin right now?
      - What number of deleted device records match a filter?
      instructions:
      - text: Count the deleted devices.
      - text: Count deleted device records matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.getAvailableExtensionProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: List registered directory extension properties
      effect: read
      questions:
      - What directory extension attributes are registered in my tenant, including by multitenant apps?
      - Can I see only the extension properties synced from on-premises?
      instructions:
      - text: List all available directory extension properties via deleted items.
      - text: Get extension property definitions where synced from on-premises is {synced}.
        slots:
          synced: requestBody.isSyncedFromOnPremises
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.getByIds'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch directory objects by a list of IDs
      effect: read
      questions:
      - How can I resolve a batch of object IDs to users, groups or devices in one request?
      - Can I restrict an ID lookup to certain object types?
      instructions:
      - text: Look up the directory objects with IDs {ids}.
        slots:
          ids: requestBody.ids
      - text: Resolve IDs {ids} but only return objects of types {types}.
        slots:
          ids: requestBody.ids
          types: requestBody.types
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted groups
      effect: read
      questions:
      - Which groups have been deleted and are still recoverable?
      - Can I search deleted groups by name?
      instructions:
      - text: List deleted groups.
      - text: Search deleted groups for {term}.
        slots:
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count deleted groups
      effect: read
      questions:
      - How many groups are in deleted items?
      - What's the number of deleted groups that match a filter?
      instructions:
      - text: Count the deleted groups.
      - text: Count deleted groups matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted service principals
      effect: read
      questions:
      - Which enterprise app service principals were deleted recently?
      - Can I filter deleted service principals by app ID?
      instructions:
      - text: List deleted service principals.
      - text: Show deleted service principals matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.servicePrincipal/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count deleted service principals
      effect: read
      questions:
      - How many service principals are waiting in the recycle bin?
      - What number of deleted service principals match a search term?
      instructions:
      - text: Count the deleted service principals.
      - text: Count deleted service principals that match {term}.
        slots:
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: List deleted users
      effect: read
      questions:
      - Which user accounts were deleted in the last few weeks?
      - Can I search deleted users by display name or email?
      instructions:
      - text: List deleted users.
      - text: Search deleted user accounts for {term}.
        slots:
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.user/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count deleted users
      effect: read
      questions:
      - How many user accounts are in deleted items?
      - What's the count of deleted users that match a filter?
      instructions:
      - text: Count the deleted users.
      - text: Count deleted user accounts matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directory/deletedItems/microsoft.graph.validateProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a group name against naming policy
      effect: read
      questions:
      - Will a Microsoft 365 group display name pass my tenant's naming policy?
      - Can I check whether a mail nickname contains blocked words before creating the group?
      instructions:
      - text: Validate display name {display_name} and mail nickname {nickname} for a group.
        slots:
          display_name: requestBody.displayName
          nickname: requestBody.mailNickname
      - text: Check {display_name} against the group naming policy on behalf of user {user_id}.
        slots:
          display_name: requestBody.displayName
          user_id: requestBody.onBehalfOfUserId
      method: generated
      generated: '2026-10-01'