Skip to content

usercredentialusagedetails.md

Latest commit

 

History

History
81 lines (63 loc) · 3.05 KB

usercredentialusagedetails.md

File metadata and controls

81 lines (63 loc) · 3.05 KB
title userCredentialUsageDetails resource type
description Represents the self-service password reset usage for a given tenant.
ms.localizationpriority medium
author egreenberg14
ms.subservice entra-monitoring-health
doc_type resourcePageType
ms.date 01/12/2026
toc.title User credential usage details (deprecated)

userCredentialUsageDetails resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Important

The user credential usage details API is deprecated and will stop returning data on August 1, 2025. Use the new User Events Summary API instead.

Represents the self-service password reset usage for a given tenant. Details include user information, status of the reset, and the reason for failure. For more information about license requirements for this feature, see Authentication Methods Activity: Permissions and licenses.

Methods

Method Return Type Description
List userCredentialUsageDetails Read properties and relationships of a userCredentialUsageDetails object.

Properties

Property Type Description
authMethod usageAuthMethod Represents the authentication method that the user used.
eventDateTime DateTimeOffset The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
failureReason String Provides the failure reason for the corresponding reset or registration workflow.
feature featureType The possible values are: registration, reset, unknownFutureValue.
id String Read-only. The unique identifier for the activity. Read-only.
isSuccess Boolean Indicates success or failure of the workflow.
userDisplayName String User name of the user performing the reset or registration workflow.
userPrincipalName String User principal name of the user performing the reset or registration workflow.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "id" : "String",
  "feature":"string",
  "userPrincipalName":"String",
  "userDisplayName": "String",
  "isSuccess" : true,
  "authMethod": "string",
  "failureReason": "String",
  "eventDateTime" : "DateTimeOffset"
}