direct_reports

Creates, updates, deletes, gets or lists a direct_reports resource.

Overview

Name	direct_reports
Type	Resource
Id	entra_id.users.direct_reports

Fields

The following fields are returned by SELECT queries:

get

Retrieved navigation property

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
deletedDateTime	string (date-time)	Date and time when this object was deleted. Always null when the object hasn't been deleted. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)

list

Retrieved collection

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
deletedDateTime	string (date-time)	Date and time when this object was deleted. Always null when the object hasn't been deleted. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	user_id, directory_object_id	ConsistencyLevel	The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable. Supports $expand.
list	select	user_id	ConsistencyLevel	Get an agentUser's direct reports. Returns the users and contacts for whom this agent user is assigned as manager.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
directory_object_id	string	The unique identifier of directoryObject
user_id	string	The unique identifier of user
ConsistencyLevel	string	Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries

SELECT examples

get

The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable. Supports $expand.

SELECT
id,
deletedDateTime
FROM entra_id.users.direct_reports
WHERE user_id = '{{ user_id }}' -- required
AND directory_object_id = '{{ directory_object_id }}' -- required
AND ConsistencyLevel = '{{ ConsistencyLevel }}'
;

list

Get an agentUser's direct reports. Returns the users and contacts for whom this agent user is assigned as manager.

SELECT
id,
deletedDateTime
FROM entra_id.users.direct_reports
WHERE user_id = '{{ user_id }}' -- required
AND ConsistencyLevel = '{{ ConsistencyLevel }}'
;