---
schema_version: "1"
id: e747c00f80711ac976f27d4d5312507bba6f14a11d569ce869ba27c9f19a4ec4
title: WorkflowTask
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_objects_workflowtask.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_workflowtask.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: c11b7e16ca6c847c8bafffe94e5cf2c2972609a7ab1d2670c9a71c154ce10883
description: Represents a workflow task that is used to fire off a specific workflow action when the specified criteria is met. Includes access to the associated WorkflowRule object in Salesforce Metadata API.
---
# WorkflowTask

Represents a workflow task that is used to fire off a specific workflow action when the specified criteria is met. Includes access to the associated WorkflowRule object in Salesforce Metadata API.

Available from API version 32.0 or later.

## Supported SOAP Calls

create(), delete(), query(), retrieve(), search(), update(), upsert()

## Supported REST HTTP Methods

Query, DELETE, GET, PATCH, POST

## Fields

| Field Name | Details |
| --- | --- |
| EntityDefinition | 
Type

[EntityDefinition](https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_objects_entitydefinition.htm "Provides row-based access to metadata about standard and custom objects.")

Properties

Filter, Group, Sort.

Description

Required. The entity definition for the object associated with the validation rule.



 |
| EntityDefinitionId | 

Type

string

Properties

Filter, Group, Sort

Description

The ID of the entity containing the workflow task.



 |
| FullName | 

Type

string

Properties

Create, Group, Nillable

Description

The full name of the associated metadata object in Metadata API.

Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.



 |
| ManageableState | 

Type

ManageableState enumerated list

Properties

Filter, Group, Nillable, Restricted picklist, Sort

Description

Indicates the manageable state of the specified component that is contained in a package:

- beta
- deleted
- deprecated
- deprecatedEditable
- installed
- installedEditable
- released
- unmanaged





 |
| Metadata | 

Type

mns:WorkflowTask

Properties

Create, Nillable, Update

Description

Workflow task metadata.

Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.



 |
| NamespacePrefix | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The namespace of the package containing the workflow task object.



 |
| Priority | 

Type

picklist

Properties

Filter, Group, Sort

Description

The task’s priority. Values are:

- High
- Normal
- Low





 |
| Status | 

Type

picklist

Properties

Filter, Group, Sort

Description

The task’s status. Values are:

- Not Started
- In Progress
- Completed
- Waiting on someone else
- Deferred





 |
| Subject | 

Type

string

Properties

Filter, Group, idLookup, Sort

Description

A subject for the workflow task. It is used if an email notification is sent when the task is assigned.



 |