presence resource type

Namespace: microsoft.graph

Contains information about a user's presence, including their availability and user activity.

Note: This resource is currently only supported for Microsoft Teams users.

This resource supports subscribing to change notifications.


Method Return Type Description
Get presence presence Get a user's presence information.
Get presence of multiple users presence collection Get the presence information for multiple users.
Set presence Set an application's presence session for a user.
Clear presence Clear an application's presence session for a user.


Property Type Description
id string The user object id
availability string collection The base presence information for a user. Possible values are Available, AvailableIdle, Away, BeRightBack, Busy, BusyIdle, DoNotDisturb, Offline, PresenceUnknown
activity string collection The supplemental information to a user's availability. Possible values are Available, Away, BeRightBack, Busy, DoNotDisturb, InACall, InAConferenceCall, Inactive, InAMeeting, Offline, OffWork, OutOfOffice, PresenceUnknown, Presenting, UrgentInterruptionsOnly.

Note: To learn more about the different presence states, see User presence in Teams.



JSON representation

The following is a JSON representation of the resource.