Microsoft Entra ID (formerly Azure AD) · OpenAPI Overlay 1.0.0

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

55 actions 55 updates phrasing extends openapi/azure-ad-devices-directoryobject-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Entra ID (formerly Azure AD)'s API. It is a proposal applied on top of the contract, not a document Microsoft Entra ID (formerly Azure AD) publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 55 · first 16 shown; the file carries all of them

$.info
$.paths['/devices/{device-id}/memberOf'].get
$.paths['/devices/{device-id}/memberOf/{directoryObject-id}'].get
$.paths['/devices/{device-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
$.paths['/devices/{device-id}/memberOf/{directoryObject-id}/microsoft.graph.group'].get
$.paths['/devices/{device-id}/memberOf/$count'].get
$.paths['/devices/{device-id}/memberOf/microsoft.graph.administrativeUnit'].get
$.paths['/devices/{device-id}/memberOf/microsoft.graph.administrativeUnit/$count'].get
$.paths['/devices/{device-id}/memberOf/microsoft.graph.group'].get
$.paths['/devices/{device-id}/memberOf/microsoft.graph.group/$count'].get
$.paths['/devices/{device-id}/registeredOwners'].get
$.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/$ref'].delete
$.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get
$.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.endpoint'].get
$.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
$.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.user'].get

OpenAPI Overlay

Raw ↑ 
# 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 Devices.directory Object API
  version: 1.0.0
extends: openapi/azure-ad-devices-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: 54
- target: $.paths['/devices/{device-id}/memberOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's direct group and unit memberships
      effect: read
      questions:
      - Which groups and administrative units is this device directly a member of?
      - How do I see the direct memberships of a device in Entra ID without nested ones?
      instructions:
      - text: List every group and administrative unit that device {device_id} belongs to directly.
        slots:
          device_id: path.device-id
      - text: Show the direct memberOf entries for device {device_id}, mixing groups and admin units.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one direct membership of a device
      effect: read
      questions:
      - Can I fetch a single directory object from a device's direct memberOf list by its id?
      - What does one specific direct membership entry of a device contain?
      instructions:
      - text: Get membership entry {directory_object_id} from the direct memberOf list of device {device_id}.
        slots:
          directory_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Fetch directory object {directory_object_id} that device {device_id} is directly a member of, whatever its type.
        slots:
          directory_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's direct membership as an admin unit
      effect: read
      questions:
      - Can I read a device's direct membership back typed as an administrative unit?
      - Is this directory object that my device directly belongs to an administrative unit, and what are its details?
      instructions:
      - text: Get administrative unit {directory_object_id} from device {device_id}'s direct memberships.
        slots:
          directory_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Cast direct membership {directory_object_id} of device {device_id} to an administrative unit and return it.
        slots:
          directory_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's direct membership as a group
      effect: read
      questions:
      - Can I read a device's direct membership back typed as a group with its group properties?
      - What group details come back for one group a device is directly in?
      instructions:
      - text: Get group {directory_object_id} from device {device_id}'s direct memberships.
        slots:
          directory_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Cast direct membership {directory_object_id} of device {device_id} to a group and return its properties.
        slots:
          directory_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's direct memberships
      effect: read
      questions:
      - How many groups and administrative units combined is a device directly a member of?
      - Is there a way to get just the number of direct memberships for a device?
      instructions:
      - text: Count all direct memberships of device {device_id}, groups and admin units together.
        slots:
          device_id: path.device-id
      - text: Return only the total of direct memberOf entries for device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List admin units a device directly belongs to
      effect: read
      questions:
      - Which administrative units has this device been placed in directly?
      - Can I filter a device's direct memberships down to administrative units only?
      instructions:
      - text: List only the administrative units device {device_id} is directly a member of.
        slots:
          device_id: path.device-id
      - text: Show the admin units that directly contain device {device_id}, leaving out groups.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count admin units a device directly belongs to
      effect: read
      questions:
      - How many administrative units directly contain a given device?
      - Can I get a count of just the admin units in a device's direct memberships?
      instructions:
      - text: Count the administrative units that device {device_id} is directly a member of.
        slots:
          device_id: path.device-id
      - text: Tell me the number of admin units directly holding device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups a device directly belongs to
      effect: read
      questions:
      - What groups is a device directly a member of, excluding administrative units?
      - Can I list a device's direct group memberships with group properties like display name?
      instructions:
      - text: List only the groups device {device_id} is directly a member of.
        slots:
          device_id: path.device-id
      - text: Give me the groups where device {device_id} sits as a direct member.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/memberOf/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count groups a device directly belongs to
      effect: read
      questions:
      - How many groups is a device directly a member of?
      - Can I get just the number of direct group memberships for one device?
      instructions:
      - text: Count the groups that device {device_id} is directly a member of.
        slots:
          device_id: path.device-id
      - text: Tell me how many groups directly hold device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's registered owners
      effect: read
      questions:
      - Who are the registered owners of this device, the users who cloud-joined or registered it?
      - How do I find which user owns a personal device registered in Entra ID?
      instructions:
      - text: List the registered owners of device {device_id} with their full objects.
        slots:
          device_id: path.device-id
      - text: Show who owns device {device_id} and return their directory details.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a specific registered owner from a device
      effect: destructive
      questions:
      - Can I remove one user as a registered owner of a device by naming the owner's id in the path?
      - What happens to a device when I take a registered owner off it?
      instructions:
      - text: Remove owner {owner_id} from the registered owners of device {device_id}.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      - text: Take user {owner_id} off as registered owner of device {device_id} using the owner-id path.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device owner as an app role assignment
      effect: read
      questions:
      - Can I read one of a device's registered owners typed as an app role assignment?
      - What app role assignment details come back for a single device owner entry?
      instructions:
      - text: Get registered owner {owner_id} of device {device_id} cast as an app role assignment.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return owner entry {owner_id} on device {device_id} as an appRoleAssignment object.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device owner as an endpoint
      effect: read
      questions:
      - Can I read one registered owner of a device typed as an endpoint object?
      - What endpoint properties does a single device owner entry expose?
      instructions:
      - text: Get registered owner {owner_id} of device {device_id} cast as an endpoint.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return owner entry {owner_id} on device {device_id} as an endpoint object.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device owner as a service principal
      effect: read
      questions:
      - Can I read a device's registered owner typed as a service principal?
      - Which service principal properties come back for one owner of a device?
      instructions:
      - text: Get registered owner {owner_id} of device {device_id} cast as a service principal.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return owner entry {owner_id} on device {device_id} as a servicePrincipal object.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device owner as a user
      effect: read
      questions:
      - Can I get a device owner's user profile, like name and email, from the owner entry?
      - What user properties come back for one registered owner of a device?
      instructions:
      - text: Get registered owner {owner_id} of device {device_id} cast as a user.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return the user profile of owner {owner_id} on device {device_id}.
        slots:
          owner_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's registered owners
      effect: read
      questions:
      - How many registered owners does a device have in total?
      - Is there a quick way to check whether a device has any owners at all?
      instructions:
      - text: Count all registered owners of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Return the total number of owners on device {device_id}, of every type.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List references to a device's registered owners
      effect: read
      questions:
      - Can I get just the reference links (@odata.id) of a device's owners instead of full user objects?
      - What is the lightweight way to list owner ids for a device?
      instructions:
      - text: List the owner references ($ref links only) for device {device_id}.
        slots:
          device_id: path.device-id
      - text: Return only the @odata.id of each registered owner of device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a registered owner to a device
      effect: write
      questions:
      - How do I make a user the registered owner of a device?
      - Can I assign an owner to a device by passing the user's @odata.id reference?
      instructions:
      - text: Add {owner_ref} as a registered owner of device {device_id}.
        slots:
          owner_ref: requestBody.@odata.id
          device_id: path.device-id
      - text: Make the user at {owner_ref} an owner of device {device_id}.
        slots:
          owner_ref: requestBody.@odata.id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a device owner by reference id
      effect: destructive
      questions:
      - Can I remove a device owner by passing the owner's @id as a query parameter?
      - Which call unlinks a registered owner when I only have its reference URL?
      instructions:
      - text: Unlink owner reference {owner_ref} from device {device_id} via the @id query parameter.
        slots:
          owner_ref: query.@id
          device_id: path.device-id
      - text: Delete the owner reference {owner_ref} on device {device_id}.
        slots:
          owner_ref: query.@id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's owners that are app role assignments
      effect: read
      questions:
      - Which of a device's registered owners are app role assignments?
      - Can I filter a device's owner list to the appRoleAssignment type only?
      instructions:
      - text: List the registered owners of device {device_id} that are app role assignments.
        slots:
          device_id: path.device-id
      - text: Show only appRoleAssignment-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.appRoleAssignment/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's app role assignment owners
      effect: read
      questions:
      - How many of a device's owners are app role assignments?
      - Can I count just the appRoleAssignment entries among a device's owners?
      instructions:
      - text: Count the app role assignment owners of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Tell me the number of appRoleAssignment-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's owners that are endpoints
      effect: read
      questions:
      - Which of a device's registered owners are endpoint objects?
      - Can I filter a device's owner list to the endpoint type?
      instructions:
      - text: List the registered owners of device {device_id} that are endpoints.
        slots:
          device_id: path.device-id
      - text: Show only endpoint-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.endpoint/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's endpoint owners
      effect: read
      questions:
      - How many of a device's owners are endpoint objects?
      - Can I count only the endpoint entries among a device's registered owners?
      instructions:
      - text: Count the endpoint owners of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Tell me the number of endpoint-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's owners that are service principals
      effect: read
      questions:
      - Are any service principals registered as owners of this device?
      - Can I list only the service principal owners of a device?
      instructions:
      - text: List the registered owners of device {device_id} that are service principals.
        slots:
          device_id: path.device-id
      - text: Show only servicePrincipal-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.servicePrincipal/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's service principal owners
      effect: read
      questions:
      - How many service principals are owners of a device?
      - Can I count only the service principal entries among a device's owners?
      instructions:
      - text: Count the service principal owners of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Tell me the number of servicePrincipal-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's owners that are users
      effect: read
      questions:
      - Which people own this device, with their user profiles?
      - Can I filter a device's owners to user accounts only?
      instructions:
      - text: List the registered owners of device {device_id} that are users.
        slots:
          device_id: path.device-id
      - text: Show only user-typed owners on device {device_id} with names and emails.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredOwners/microsoft.graph.user/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's user owners
      effect: read
      questions:
      - How many user accounts are registered owners of a device?
      - Can I count only the people among a device's owners?
      instructions:
      - text: Count the user owners of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Tell me the number of user-typed owners on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's registered users
      effect: read
      questions:
      - Who are the registered users of a device, as opposed to its owners?
      - Which users are signed up on a cloud-joined or personal device?
      instructions:
      - text: List the registered users of device {device_id} with their full objects.
        slots:
          device_id: path.device-id
      - text: Show everyone registered as a user of device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/{directoryObject-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a specific registered user from a device
      effect: destructive
      questions:
      - Can I remove one registered user from a device by putting the user's id in the path?
      - What happens when a user is removed as a registered user of a device?
      instructions:
      - text: Remove registered user {user_object_id} from device {device_id}.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Take {user_object_id} off the registered users of device {device_id} using the user-id path.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's registered user as app role assignment
      effect: read
      questions:
      - Can I read one registered-user entry of a device typed as an app role assignment?
      - What appRoleAssignment details come back for a single registered user of a device?
      instructions:
      - text: Get registered user {user_object_id} of device {device_id} cast as an app role assignment.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return registered-user entry {user_object_id} on device {device_id} as an appRoleAssignment.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/{directoryObject-id}/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's registered user as an endpoint
      effect: read
      questions:
      - Can I read one registered-user entry of a device typed as an endpoint?
      - What endpoint properties does a single registered user of a device expose?
      instructions:
      - text: Get registered user {user_object_id} of device {device_id} cast as an endpoint.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return registered-user entry {user_object_id} on device {device_id} as an endpoint object.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's registered user as service principal
      effect: read
      questions:
      - Can I read a device's registered-user entry typed as a service principal?
      - Which service principal fields come back for one registered user of a device?
      instructions:
      - text: Get registered user {user_object_id} of device {device_id} cast as a service principal.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return registered-user entry {user_object_id} on device {device_id} as a servicePrincipal.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's registered user profile
      effect: read
      questions:
      - Can I get the user profile of one person registered on a device?
      - What user properties come back for a single registered user of a device?
      instructions:
      - text: Fetch the person behind registered-user entry {user_object_id} on device {device_id}.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      - text: Return the user profile of registered user {user_object_id} on device {device_id}.
        slots:
          user_object_id: path.directoryObject-id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's registered users
      effect: read
      questions:
      - How many registered users does a device have in total?
      - Is there a quick way to check whether anyone is registered as a user on a device?
      instructions:
      - text: Count all registered users of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Return the total number of registered users on device {device_id}, of every type.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List references to a device's registered users
      effect: read
      questions:
      - Can I get only the @odata.id links of a device's registered users instead of full objects?
      - What is the lightweight way to list registered-user ids for a device?
      instructions:
      - text: List the registered-user references ($ref links only) for device {device_id}.
        slots:
          device_id: path.device-id
      - text: Return only the @odata.id of each registered user of device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a registered user to a device
      effect: write
      questions:
      - How do I register a user on a device in Entra ID?
      - Can I add a registered user to a device by passing the user's @odata.id reference?
      instructions:
      - text: Add {user_ref} as a registered user of device {device_id}.
        slots:
          user_ref: requestBody.@odata.id
          device_id: path.device-id
      - text: Register the user at {user_ref} on device {device_id}.
        slots:
          user_ref: requestBody.@odata.id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a registered user from a device by reference
      effect: destructive
      questions:
      - Can I remove a device's registered user by passing its @id as a query parameter?
      - Which call unlinks a registered user when I only have the reference URL?
      instructions:
      - text: Unlink registered-user reference {user_ref} from device {device_id} via the @id query parameter.
        slots:
          user_ref: query.@id
          device_id: path.device-id
      - text: Delete the registered-user reference {user_ref} on device {device_id}.
        slots:
          user_ref: query.@id
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's registered users as app role grants
      effect: read
      questions:
      - Which of a device's registered users are app role assignments?
      - Can I filter a device's registered-user list to the appRoleAssignment type only?
      instructions:
      - text: List the registered users of device {device_id} that are app role assignments.
        slots:
          device_id: path.device-id
      - text: Show only appRoleAssignment-typed registered users on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/microsoft.graph.appRoleAssignment/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's app role assignment registered users
      effect: read
      questions:
      - How many of a device's registered users are app role assignments?
      - Can I count just the appRoleAssignment entries among a device's registered users?
      instructions:
      - text: Count the app role assignment registered users of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Tell me the number of appRoleAssignment-typed registered users on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: List a device's registered users that are endpoints
      effect: read
      questions:
      - Which of a device's registered users are endpoint objects?
      - Can I filter a device's registered-user list to the endpoint type?
      instructions:
      - text: List the registered users of device {device_id} that are endpoints.
        slots:
          device_id: path.device-id
      - text: Show only endpoint-typed registered users on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/devices/{device-id}/registeredUsers/microsoft.graph.endpoint/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a device's endpoint registered users
      effect: read
      questions:
      - How many of a device's registered users are endpoint objects?
      - Is there a tally of endpoint objects registered as users on one device?
      instructions:
      - text: Count the endpoint registered users of device {device_id}.
        slots:
          device_id: path.device-id
      - text: Tell me the number of endpoint-typed registered users on device {device_id}.
        slots:
          device_id: path.device-id
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/overlays/azure-ad-devices-directoryobject-api-phrasing-overlay.yaml