LifecycleWorkflows.Read.All

Allows the app to list and read all workflows, tasks and related lifecycle workflows resources on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the LifecycleWorkflows.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	7c67316a-232a-4b84-be22-cea2c0906404	9bcb9916-765a-42af-bf77-02282e26b01a
DisplayText	Read all lifecycle workflows resources	Read all lifecycle workflows resources
Description	Allows the app to list and read all workflows, tasks and related lifecycle workflows resources without a signed-in user.	Allows the app to list and read all workflows, tasks and related lifecycle workflows resources on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /identityGovernance/lifecycleWorkflows/customTaskExtensions
	GET /identityGovernance/lifecycleWorkflows/customTaskExtensions/{customTaskExtensionId}
	GET /identityGovernance/lifecycleWorkflows/deletedItems/workflows/
	GET /identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflowId}/
	GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/settings
	GET /identityGovernance/lifecycleWorkflows/taskDefinitions
	GET /identityGovernance/lifecycleWorkflows/taskDefinitions/{taskDefinitionId}
	GET /identityGovernance/lifecycleWorkflows/workflows
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow_id}/runs/{runId}/userProcessingResults/{userProcessingResultId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/userProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}
	GET /identitygovernance/lifecycleWorkflows/workflows/{workflowId}/executionScope
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/summary(startDateTime={timestamp},endDateTime={timestamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports/{taskReportId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports/summary(startDateTime={timestamp},endDateTime={timestamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/tasks
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/tasks/{taskId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/summary(startDateTime={TimeStamp},endDateTime={TimeStamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions/{workflowVersion-versionNumber}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions/{workflowVersion-versionNumber}/tasks
	GET /identityGovernance/lifecycleWorkflows/workflowTemplates
	GET /identityGovernance/lifecycleWorkflows/workflowTemplates/{workflowTemplateId}

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /identityGovernance/lifecycleWorkflows/customTaskExtensions
	GET /identityGovernance/lifecycleWorkflows/customTaskExtensions/{customTaskExtensionId}
	GET /identityGovernance/lifecycleWorkflows/deletedItems/workflows/
	GET /identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflowId}/
	GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime})
	GET /identityGovernance/lifecycleWorkflows/settings
	GET /identityGovernance/lifecycleWorkflows/taskDefinitions
	GET /identityGovernance/lifecycleWorkflows/taskDefinitions/{taskDefinitionId}
	GET /identityGovernance/lifecycleWorkflows/workflows
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow_id}/runs/{runId}/userProcessingResults/{userProcessingResultId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/userProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}
	GET /identitygovernance/lifecycleWorkflows/workflows/{workflowId}/executionScope
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/summary(startDateTime={timestamp},endDateTime={timestamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports/{taskReportId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports/summary(startDateTime={timestamp},endDateTime={timestamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/tasks
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/tasks/{taskId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/summary(startDateTime={TimeStamp},endDateTime={TimeStamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions/{workflowVersion-versionNumber}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions/{workFlowVersion-versionNumber}/tasks
	GET /identityGovernance/lifecycleWorkflows/workflowTemplates
	GET /identityGovernance/lifecycleWorkflows/workflowTemplates/{workflowTemplateId}

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgIdentityGovernanceLifecycleWorkflow
	Get-MgIdentityGovernanceLifecycleWorkflowCustomTaskExtension
	Get-MgIdentityGovernanceLifecycleWorkflowDeletedItemWorkflow
	Get-MgIdentityGovernanceLifecycleWorkflowExecutionScope
	Get-MgIdentityGovernanceLifecycleWorkflowRun
	Get-MgIdentityGovernanceLifecycleWorkflowRunTaskProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowRunUserProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowRunUserProcessingResultTaskProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowSetting
	Get-MgIdentityGovernanceLifecycleWorkflowTask
	Get-MgIdentityGovernanceLifecycleWorkflowTaskDefinition
	Get-MgIdentityGovernanceLifecycleWorkflowTaskReport
	Get-MgIdentityGovernanceLifecycleWorkflowTaskReportTaskProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowTemplate
	Get-MgIdentityGovernanceLifecycleWorkflowUserProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowVersion
	Get-MgIdentityGovernanceLifecycleWorkflowVersionTask
	Invoke-MgGraphIdentityGovernanceLifecycleWorkflowInsight
	Invoke-MgSummaryIdentityGovernanceLifecycleWorkflowRun
	Invoke-MgSummaryIdentityGovernanceLifecycleWorkflowUserProcessingResult
	Invoke-MgTopIdentityGovernanceLifecycleWorkflowInsightTaskProcessedSummary
	Invoke-MgTopIdentityGovernanceLifecycleWorkflowInsightWorkflowProcessedSummary
	Invoke-MgWorkflowIdentityGovernanceLifecycleWorkflowInsightProcessedSummary

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaIdentityGovernanceLifecycleWorkflow
	Get-MgBetaIdentityGovernanceLifecycleWorkflowCustomTaskExtension
	Get-MgBetaIdentityGovernanceLifecycleWorkflowDeletedItemWorkflow
	Get-MgBetaIdentityGovernanceLifecycleWorkflowExecutionScope
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRun
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRunTaskProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRunUserProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRunUserProcessingResultTaskProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowSetting
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTask
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTaskDefinition
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTaskReport
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTaskReportTaskProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTemplate
	Get-MgBetaIdentityGovernanceLifecycleWorkflowUserProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowVersion
	Get-MgBetaIdentityGovernanceLifecycleWorkflowVersionTask
	Invoke-MgBetaGraphIdentityGovernanceLifecycleWorkflowInsight
	Invoke-MgBetaSummaryIdentityGovernanceLifecycleWorkflowRun
	Invoke-MgBetaSummaryIdentityGovernanceLifecycleWorkflowUserProcessingResult
	Invoke-MgBetaTopIdentityGovernanceLifecycleWorkflowInsightTaskProcessedSummary
	Invoke-MgBetaTopIdentityGovernanceLifecycleWorkflowInsightWorkflowProcessedSummary
	Invoke-MgBetaWorkflowIdentityGovernanceLifecycleWorkflowInsightProcessedSummary

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: customTaskExtension

Property	Type	Description
authenticationConfiguration	microsoft.graph.customExtensionAuthenticationConfiguration	Configuration for securing the API call to the logic app. Inherited from customCalloutExtension. Required.
callbackConfiguration	microsoft.graph.identityGovernance.customTaskExtensionCallbackConfiguration	The callback configuration for a custom task extension.
clientConfiguration	microsoft.graph.customExtensionClientConfiguration	HTTP connection settings that define how long Microsoft Entra ID can wait for a connection to a logic app, how many times you can retry a timed-out connection and the exception scenarios when retries are allowed. Inherited from customCalloutExtension.
createdDateTime	DateTimeOffset	When the custom task extension was created. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
description	String	Describes the purpose of the custom task extension for administrative use. Inherited from customCalloutExtension. Optional.
displayName	String	A unique string that identifies the custom task extension. Inherited from customCalloutExtension. Required. Supports `$filter`(`eq`, `ne`) and `$orderby`.
endpointConfiguration	microsoft.graph.customExtensionEndpointConfiguration	Details for allowing the custom task extension to call the logic app. Inherited from customCalloutExtension.
id	String	Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
lastModifiedDateTime	DateTimeOffset	When the custom extension was last modified. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Graph reference: lifecycleManagementSettings

Property	Type	Description
workflowScheduleIntervalInHours	Int32	The interval in hours at which all workflows running in the tenant should be scheduled for execution. This interval has a minimum value of 1 and a maximum value of 24. The default value is 3 hours.
emailSettings	microsoft.graph.emailSettings	Defines the settings for emails sent out from email-specific tasks within workflows. Accepts 2 parameters senderDomain- Defines the domain of who is sending the email. useCompanyBranding- A Boolean value that defines if company branding is to be used with the email.

Graph reference: run

Property	Type	Description
completedDateTime	DateTimeOffset	The date time that the run completed. Value is `null` if the workflow hasn't completed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failedTasksCount	Int32	The number of tasks that failed in the run execution.
failedUsersCount	Int32	The number of users that failed in the run execution.
id	String	A unique identifier for the workflow run.
lastUpdatedDateTime	DateTimeOffset	The datetime that the run was last updated. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	The run execution status. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
scheduledDateTime	DateTimeOffset	The date time that the run is scheduled to be executed for a workflow. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
startedDateTime	DateTimeOffset	The date time that the run execution started. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
successfulUsersCount	Int32	The number of successfully completed users in the run.
totalUsersCount	Int32	The total number of users in the workflow execution.
totalTasksCounts	Int32	The total number of tasks in the run execution.
totalUnprocessedTasksCount	Int32	The total number of unprocessed tasks in the run execution.
workflowExecutionType	microsoft.graph.identityGovernance.workflowExecutionType	The execution type of the workflows associated with the run. The possible values are: `scheduled`, `onDemand`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.

Graph reference: runSummary

Property	Type	Description
failedRuns	Int32	The number of failed workflow runs.
failedTasks	Int32	The number of failed tasks of a workflow.
successfulRuns	Int32	The number of successful workflow runs.
totalRuns	Int32	The total number of runs for a workflow.
totalTasks	Int32	The total number of tasks processed by a workflow.
totalUsers	Int32	The total number of users processed by a workflow.

Graph reference: identitygovernance-task

Property	Type	Description
arguments	microsoft.graph.keyValuePair collection	Arguments included within the task. For guidance to configure this property, see Configure the arguments for built-in Lifecycle Workflow tasks. Required.
category	microsoft.graph.identityGovernance.lifecycleTaskCategory	The category of the task. The possible values are: `joiner`, `leaver`, `unknownFutureValue`. This property is multi-valued and the same task can apply to both `joiner` and `leaver` categories. Supports `$filter`(`eq`, `ne`).
continueOnError	Boolean	A Boolean value that specifies whether, if this task fails, the workflow stops, and subsequent tasks aren't run. Optional.
description	String	A string that describes the purpose of the task for administrative use. Optional.
displayName	String	A unique string that identifies the task. Required. Supports `$filter`(`eq`, `ne`) and `orderBy`.
executionSequence	Int32	An integer that states in what order the task runs in a workflow. Supports `$orderby`.
id	String	Identifier used for individually addressing a specific task. Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
isEnabled	Boolean	A Boolean value that denotes whether the task is set to run or not. Optional. Supports `$filter`(`eq`, `ne`) and `orderBy`.
taskDefinitionId	String	A unique template identifier for the task. For more information about the tasks that Lifecycle Workflows currently supports and their unique identifiers, see Configure the arguments for built-in Lifecycle Workflow tasks. Required. Supports `$filter`(`eq`, `ne`).

Graph reference: taskDefinition

Property	Type	Description
category	microsoft.graph.identityGovernance.lifecycleTaskCategory	The category of the HR function that the tasks created using this definition can be used with. The possible values are: `joiner`, `mover`, `leaver`, `unknownFutureValue`. This is a multi-valued enumeration whose allowed combinations are `joiner`, `joiner,leaver`, or `leaver`. Supports `$filter`(`eq`, `ne`, `has`) and `$orderby`.
continueOnError	Boolean	Defines if the workflow will continue if the task has an error.
description	String	The description of the taskDefinition.
displayName	String	The display name of the taskDefinition. Supports `$filter`(`eq`, `ne`) and `$orderby`.
id	String	The unique identifier for the taskDefinition. Inherited from entity.
parameters	microsoft.graph.identityGovernance.parameter collection	The parameters that must be supplied when creating a workflow task object. Supports `$filter`(`any`).
version	Int32	The version number of the taskDefinition. New records are pushed when we add support for new parameters. Supports `$filter`(`ge`, `gt`, `le`, `lt`, `eq`, `ne`) and `$orderby`.

Graph reference: taskProcessingResult

Property	Type	Description
completedDateTime	DateTimeOffset	The date time when taskProcessingResult execution ended. Value is `null` if task execution is still in progress. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
createdDateTime	DateTimeOffset	The date time when the taskProcessingResult was created. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failureReason	String	Describes why the taskProcessingResult has failed.
id	String	Identifier used for individually addressing a specific task processing result. Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	Describes the execution status of the `taskProcessingResult`. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
startedDateTime	DateTimeOffset	The date time when taskProcessingResult execution started. Value is `null` if task execution has not yet started. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Graph reference: taskReport

Property	Type	Description
completedDateTime	DateTimeOffset	The date time that the associated run completed. Value is `null` if the run has not completed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failedUsersCount	Int32	The number of users in the run execution for which the associated task failed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
id	String	The unique identifier of the task report. Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
lastUpdatedDateTime	DateTimeOffset	The date and time that the task report was last updated.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	The processing status of the associated task based on the taskProcessingResults. The possible values are based on the number of `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, and `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
runId	String	The unique identifier of the associated run.
startedDateTime	DateTimeOffset	The date time that the associated run started. Value is `null` if the run has not started.
successfulUsersCount	Int32	The number of users in the run execution for which the associated task succeeded. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
totalUsersCount	Int32	The total number of users in the run execution for which the associated task was scheduled to execute. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
unprocessedUsersCount	Int32	The number of users in the run execution for which the associated task is `queued`, `in progress`, or `canceled`. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Graph reference: taskReportSummary

Property	Type	Description
failedTasks	Int32	The number of failed tasks in a report.
successfulTasks	Int32	The total number of successful tasks in a report.
totalTasks	Int32	The total number of tasks in a report.
unprocessedTasks	Int32	The number of unprocessed tasks in a report.

Graph reference: timeBasedAttributeTrigger

Property	Type	Description
offsetInDays	Int32	How many days before or after the time-based attribute specified the workflow should trigger. For example, if the attribute is `employeeHireDate` and offsetInDays is -1, then the workflow should trigger one day before the employee hire date. The value can range between -180 and 180 days.
timeBasedAttribute	microsoft.graph.identityGovernance.workflowTriggerTimeBasedAttribute	Determines which time-based identity property to reference. The possible values are: `employeeHireDate`, `employeeLeaveDateTime`, `createdDateTime`, `unknownFutureValue`.

Graph reference: topTasksInsightsSummary

Property	Type	Description
failedTasks	Int32	Count of failed runs of the task.
failedUsers	Int32	Count of failed users who were processed by the task.
successfulTasks	Int32	Count of successful runs of the task.
successfulUsers	Int32	Count of successful users processed by the task.
taskDefinitionDisplayName	String	The name of the task.
taskDefinitionId	String	The task ID.
totalTasks	Int32	Count of total runs of the task.
totalUsers	Int32	Count of total users processed by the task.

Graph reference: topWorkflowsInsightsSummary

Property	Type	Description
failedRuns	Int32	Count of failed runs for workflow.
failedUsers	Int32	Count of failed users who were processed.
successfulRuns	Int32	Count of successful runs of the workflow.
successfulUsers	Int32	Count of successful users processed by the workflow.
totalRuns	Int32	Count of total runs of workflow.
totalUsers	Int32	Total number of users processed by the workflow.
workflowCategory	microsoft.graph.identityGovernance.lifecycleWorkflowCategory	The category of the workflow. The possible values are: `joiner`, `leaver`, `unknownFutureValue`, `mover`. Use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this evolvable enum: `mover`.
workflowDisplayName	String	The name of the workflow.
workflowId	String	The workflow ID.
workflowVersion	Int32	The version of the workflow that was a top workflow ran.

Graph reference: triggerAndScopeBasedConditions

Property	Type	Description
scope	microsoft.graph.subjectSet	Defines who the workflow runs for.
trigger	microsoft.graph.identityGovernance.workflowExecutionTrigger	What triggers a workflow to run.

Graph reference: userProcessingResult

Property	Type	Description
completedDateTime	DateTimeOffset	The date time that the workflow execution for a user completed. Value is null if the workflow hasn't completed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failedTasksCount	Int32	The number of tasks that failed in the workflow execution.
id	String	Identifier used for individually addressing a specific user processing result.Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	The workflow execution status. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
scheduledDateTime	DateTimeOffset	The date time that the workflow is scheduled to be executed for a user. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
startedDateTime	DateTimeOffset	The date time that the workflow execution started. Value is `null` if the workflow execution has not started. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
totalTasksCount	Int32	The total number of tasks that in the workflow execution.
totalUnprocessedTasksCount	Int32	The total number of unprocessed tasks for the workflow.
workflowExecutionType	microsoft.graph.identityGovernance.workflowExecutionType	Describes the execution type of the workflow. The possible values are: `scheduled`, `onDemand`, `unknownFutureValue`. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
workflowVersion	Int32	The version of the workflow that was executed.

Graph reference: userSummary

Property	Type	Description
failedTasks	Int32	The number of failed tasks for users in a user summary.
failedUsers	Int32	The number of failed users in a user summary.
successfulUsers	Int32	The number of successful users in a user summary.
totalTasks	Int32	The total tasks of users in a user summary.
totalUsers	Int32	The total number of users in a user summary

Graph reference: workflow

Property	Type	Description
category	microsoft.graph.identityGovernance.lifecycleWorkflowCategory	The category of the HR function supported by the workflows created using this template. A workflow can only belong to one category. The possible values are: `joiner`, `leaver`, `mover`, `unknownFutureValue`. Inherited from workflowBase. Required. Supports `$filter`(`eq`,`ne`) and `$orderby`
createdDateTime	DateTimeOffset	When the `workflow` was created. Inherited from workflowBase. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
deletedDateTime	DateTimeOffset	When the workflow was deleted. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
description	String	The description of the `workflow`. Inherited from workflowBase. Optional.
displayName	String	The display name of the `workflow`. Inherited from workflowBase. Required. Supports `$filter`(`eq`, `ne`) and `orderby`.
executionConditions	microsoft.graph.identityGovernance.workflowExecutionConditions	Conditions describing when to execute the workflow and the criteria to identify in-scope subject set. Inherited from workflowBase. Required.
id	String	Identifier used for individually addressing a specific workflow. Supports `$filter`(`eq`, `ne`) and `$orderby`.
isEnabled	Boolean	Whether the workflow is enabled or disabled. If this setting is `true`, the workflow can be run on demand or on schedule when isSchedulingEnabled is `true`. Inherited from workflowBase. Optional. Defaults to `true`. Supports `$filter`(`eq`, `ne`) and `orderBy`.
isSchedulingEnabled	Boolean	If `true`, the Lifecycle Workflow engine executes the workflow based on the schedule defined by tenant settings. Cannot be `true` for a disabled workflow (where isEnabled is `false`). Inherited from workflowBase. Optional. Defaults to `false`. Supports `$filter`(`eq`, `ne`) and `orderBy`.
lastModifiedDateTime	DateTimeOffset	The date time when the `workflow` was last modified. Inherited from workflowBase. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
nextScheduleRunDateTime	DateTimeOffset	The date time when the `workflow` is expected to run next based on the schedule interval, if there are any users matching the execution conditions. Supports `$filter`(`lt`,`gt`) and `$orderby`.
version	Int32	The current version number of the workflow. Value is 1 when the workflow is first created. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Graph reference: workflowsInsightsByCategory

Property	Type	Description
failedJoinerRuns	Int32	Failed "Joiner" workflows processed in a tenant.
failedLeaverRuns	Int32	Failed "Leaver" workflows processed in a tenant.
failedMoverRuns	Int32	Failed "Mover" workflows processed in a tenant.
successfulJoinerRuns	Int32	Successful "Joiner" workflows processed in a tenant.
successfulLeaverRuns	Int32	Successful "Leaver" workflows processed in a tenant.
successfulMoverRuns	Int32	Successful "Mover" workflows processed in a tenant.
totalJoinerRuns	Int32	Total "Joiner" workflows processed in a tenant.
totalLeaverRuns	Int32	Total "Leaver" workflows processed in a tenant.
totalMoverRuns	Int32	Total "*M

Graph reference: workflowsInsightsSummary

Property	Type	Description
failedRuns	Int32	Count of failed workflow runs processed in the tenant.
failedTasks	Int32	Count of failed tasks processed in the tenant.
failedUsers	Int32	Count of failed users processed by workflows in the tenant.
successfulRuns	Int32	Count of successful workflow runs processed in the tenant.
successfulTasks	Int32	Count of successful tasks processed in the tenant.
successfulUsers	Int32	Count of successful users processed by workflows in the tenant.
totalRuns	Int32	Count of total workflows processed in the tenant.
totalTasks	Int32	Count of total tasks processed by workflows in the tenant.
totalUsers	Int32	Count of total users processed by workflows in the tenant.

Graph reference: workflowTemplate

Property	Type	Description
category	microsoft.graph.identityGovernance.lifecycleWorkflowCategory	The category of the workflow template. The possible values are: `joiner`, `mover`, `leaver`,`unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
description	String	The description of the `workflowTemplate`.
displayName	String	The display name of the `workflowTemplate`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
executionConditions	microsoft.graph.identityGovernance.workflowExecutionConditions	Conditions describing when to execute the workflow and the criteria to identify in-scope subject set.
id	String	The unique identifier for the `workflowTemplate`.Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.

Graph reference: workflowVersion

Property	Type	Description
category	microsoft.graph.identityGovernance.lifecycleWorkflowCategory	The category of the HR function supported by the workflows created using this template. A workflow can only belong to one category. The possible values are: `joiner`, `leaver`, `mover`,`unknownFutureValue`. Inherited from workflowBase. Supports `$filter`(`eq`,`ne`) and `$orderby`
createdDateTime	DateTimeOffset	The date time when the `workflow` was versioned. Inherited from workflowBase. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
description	String	The description of the `workflowversion`. Inherited from workflowBase.
displayName	String	The display name of the `workflowversion`. Inherited from workflowBase. Supports `$filter`(`eq`, `ne`) and `orderby`.
executionConditions	microsoft.graph.identityGovernance.workflowExecutionConditions	Conditions describing when to execute the workflow and the criteria to identify in-scope subject set. Inherited from workflowBase.
isEnabled	Boolean	Whether the workflow is enabled or disabled. If this setting is `true`, the workflow can be run on demand or on schedule when isSchedulingEnabled is `true`. Inherited from workflowBase. Supports `$filter`(`eq`, `ne`) and `orderBy`.
isSchedulingEnabled	Boolean	If `true`, the Lifecycle Workflow engine executes the workflow based on the schedule defined by tenant settings. Cannot be `true` for a disabled workflow (where isEnabled is `false`). Inherited from workflowBase. Supports `$filter`(`eq`, `ne`) and `orderBy`.
lastModifiedDateTime	DateTimeOffset	The date time when the `workflow` was last modified. Inherited from workflowBase. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
versionNumber	Int32	The version of the workflow. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Table of Contents

LifecycleWorkflows.Read.All

Graph Methods

Resources