# 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' - target: $.paths['/devices/{device-id}/registeredUsers/microsoft.graph.servicePrincipal'].get update: x-apievangelist-phrasing: intent: List a device's registered service principals effect: read questions: - Are any service principals registered as users of this device? - Can I list only the service principal registered users of a device? instructions: - text: List the registered users of device {device_id} that are service principals. slots: device_id: path.device-id - text: Show only servicePrincipal-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.servicePrincipal/$count'].get update: x-apievangelist-phrasing: intent: Count a device's registered service principals effect: read questions: - How many service principals are registered users of a device? - Can I count only the service principal entries among a device's registered users? instructions: - text: Count the service principal registered users of device {device_id}. slots: device_id: path.device-id - text: Tell me the number of servicePrincipal-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.user'].get update: x-apievangelist-phrasing: intent: List people registered on a device effect: read questions: - Which people are registered users of this device, with their user profiles? - Can I filter a device's registered users to actual user accounts? instructions: - text: List the registered users of device {device_id} that are user accounts. slots: device_id: path.device-id - text: Show only user-typed registered users 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}/registeredUsers/microsoft.graph.user/$count'].get update: x-apievangelist-phrasing: intent: Count people registered on a device effect: read questions: - How many user accounts are registered users of a device? - Can I count only the people among a device's registered users? instructions: - text: Count the user-account registered users of device {device_id}. slots: device_id: path.device-id - text: Tell me the number of user-typed registered users on device {device_id}. slots: device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf'].get update: x-apievangelist-phrasing: intent: List all memberships of a device including nested effect: read questions: - Which groups and administrative units does a device belong to, including through nested groups? - How do I get a device's full transitive membership, not just direct parents? instructions: - text: List every group and admin unit device {device_id} belongs to, directly or through nesting. slots: device_id: path.device-id - text: Show the transitive memberOf chain for device {device_id}. slots: device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf/{directoryObject-id}'].get update: x-apievangelist-phrasing: intent: Get one transitive membership of a device effect: read questions: - Can I fetch one object from a device's transitive (nested) memberships by id? - Is a device inherited into this particular group or unit through nesting, and what is it? instructions: - text: Get entry {directory_object_id} from the transitive memberships of device {device_id}. slots: directory_object_id: path.directoryObject-id device_id: path.device-id - text: Fetch nested membership {directory_object_id} of device {device_id}, 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}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get update: x-apievangelist-phrasing: intent: Get a device's transitive membership as an admin unit effect: read questions: - Can I read one of a device's nested memberships typed as an administrative unit? - What admin unit details come back for a unit a device inherits membership in? instructions: - text: Get administrative unit {directory_object_id} from device {device_id}'s transitive memberships. slots: directory_object_id: path.directoryObject-id device_id: path.device-id - text: Cast nested membership {directory_object_id} of device {device_id} to an administrative unit. slots: directory_object_id: path.directoryObject-id device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.group'].get update: x-apievangelist-phrasing: intent: Get a device's transitive membership as a group effect: read questions: - Can I read one of a device's nested memberships typed as a group? - What group details come back for a group a device is in through nesting? instructions: - text: Get group {directory_object_id} from device {device_id}'s transitive memberships. slots: directory_object_id: path.directoryObject-id device_id: path.device-id - text: Cast nested membership {directory_object_id} of device {device_id} to a group 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}/transitiveMemberOf/$count'].get update: x-apievangelist-phrasing: intent: Count all memberships of a device including nested effect: read questions: - How many groups and units does a device belong to once nested memberships are counted? - Can I get the total transitive membership count for a device? instructions: - text: Count all transitive memberships of device {device_id}, groups and admin units together. slots: device_id: path.device-id - text: Return the number of nested and direct memberOf entries for device {device_id}. slots: device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf/microsoft.graph.administrativeUnit'].get update: x-apievangelist-phrasing: intent: List admin units a device belongs to via nesting effect: read questions: - Which administrative units include a device, counting nested memberships? - Can I list a device's transitive memberships filtered to administrative units? instructions: - text: List the administrative units device {device_id} belongs to, including through nesting. slots: device_id: path.device-id - text: Show transitive admin unit memberships of device {device_id}, leaving out groups. slots: device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf/microsoft.graph.administrativeUnit/$count'].get update: x-apievangelist-phrasing: intent: Count admin units a device belongs to via nesting effect: read questions: - How many administrative units include a device once nested memberships are counted? - Can I count only the admin units in a device's transitive memberships? instructions: - text: Count the administrative units device {device_id} belongs to transitively. slots: device_id: path.device-id - text: Tell me how many admin units hold device {device_id}, nested ones included. slots: device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf/microsoft.graph.group'].get update: x-apievangelist-phrasing: intent: List groups a device belongs to via nesting effect: read questions: - What groups is a device in when nested group memberships are expanded? - Can I list a device's transitive memberships filtered to groups only? instructions: - text: List the groups device {device_id} belongs to, including through nested groups. slots: device_id: path.device-id - text: Show transitive group memberships of device {device_id}, leaving out admin units. slots: device_id: path.device-id method: generated generated: '2026-10-01' - target: $.paths['/devices/{device-id}/transitiveMemberOf/microsoft.graph.group/$count'].get update: x-apievangelist-phrasing: intent: Count groups a device belongs to via nesting effect: read questions: - How many groups is a device in once nested group memberships are counted? - Can I count only the groups in a device's transitive memberships? instructions: - text: Count the groups device {device_id} belongs to transitively. slots: device_id: path.device-id - text: Tell me how many groups hold device {device_id}, nested ones included. slots: device_id: path.device-id method: generated generated: '2026-10-01'