profilePhoto resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a profile photo of a user, group, team, or Outlook contact accessed from Exchange Online or Microsoft Entra ID. The data is binary and not encoded in base-64.

The supported sizes of HD photos on Exchange Online are as follows: 48x48, 64x64, 96x96, 120x120, 240x240, 360x360,432x432, 504x504, and 648x648. In Microsoft Entra ID, photos can be any dimension.

Methods

Method Return type Description
Get profilePhoto profilePhoto Read the properties and relationships of a profile photo object.
Update profilePhoto profilePhoto Update the properties of a profile photo object.
Delete profilePhoto profilePhoto Delete the profile photo of a user or group.

Note

  • Managing users' photos using the Microsoft Graph API is currently not supported in Azure AD B2C tenants.

  • The delete operation supports only user or group photos, but not Outlook contact nor Teams photos.

Properties

Property Type Description
id string Read-only.
height int32 The height of the photo. Read-only.
width int32 The width of the photo. Read-only.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "id": "String",
  "height": 240,
  "width": 240
}