Edit

taskDefinition resource type

Namespace: microsoft.graph.identityGovernance

Represents the built-in tasks that you can use to construct tasks for lifecycle workflows. Each task has a unique template identifier. For a full list of available built-in tasks, see Configure the arguments for built-in Lifecycle Workflow tasks.

Inherits from entity.

Methods

Method Return type Description
List microsoft.graph.identityGovernance.taskDefinition collection Get a list of the taskDefinition objects and their properties.
Get microsoft.graph.identityGovernance.taskDefinition Read the properties and relationships of a taskDefinition object.

Properties

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. This flagged enumeration allows multiple members to be selected simultaneously. The possible values are: joiner, leaver, unknownFutureValue, mover, extensibility. Use the Prefer: include-unknown-enum-members request header to get the following members in this evolvable enum: mover, extensibility.

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.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.identityGovernance.taskDefinition",
  "id": "String (identifier)",
  "category": "String",
  "continueOnError": "Boolean",
  "description": "String",
  "displayName": "String",
  "parameters": [
    {
      "@odata.type": "microsoft.graph.identityGovernance.parameter"
    }
  ],
  "version": "Integer"
}