---
schema_version: "1"
id: c516f29d26d9da61c815f1313cc3cbe964bda76919fa084fff02e86debd147f8
title: TaskStatus
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_taskstatus.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_taskstatus.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3911dc33f03c554ba04d7f7aa7976f9a2b99b6d232c55de0bf3f30a1daf9783a
description: Represents the status of a task, such as Not Started, Completed, or Closed.
---
# TaskStatus

Represents the status of a task, such as Not Started, Completed, or Closed.

![Important](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

## Supported Calls

describeSObjects(), query(), retrieve()

## Special Access Rules

Customer Portal users can't access this object.

## Fields

| Field | Details |
| --- | --- |
| ApiName | 
Type

string

Properties

Filter, Group, idLookup, Sort

Description

Uniquely identifies a picklist value so it can be retrieved without using an ID or master label.



 |
| IsClosed | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

Indicates whether this task status value represents a closed task (true) or not (false). Multiple task status values can represent a closed task.



 |
| IsDefault | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

Indicates whether the status is the default task status value (true) or not (false) in the picklist.



 |
| MasterLabel | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

Master label for this task status value. This display value is the internal label that doesn’t get translated. Limit: 255 characters.



 |
| SortOrder | 

Type

int

Properties

Filter, Group, Nillable, Sort

Description

Number used to sort this value in the task status picklist. These numbers aren’t guaranteed to be sequential, as some previous task status values might have been deleted.



 |

## Usage

This object represents a value in the task status picklist. The task status picklist provides additional information about the status of a task , such as whether a given status value represents an open or closed task. Your client application can query this object to retrieve the set of values in the task status picklist, and then use that information while processing task records to determine more information about a given task. For example, the application could test whether a given task is open or closed based on the task Status value and the value of the IsClosed property in the associated TaskStatus record.

#### See Also

- [Overview of Salesforce Objects and Fields](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_concepts.htm "Salesforce objects and fields are analogous to database tables and the table columns. Objects and fields structure data. For example, the central object in the Salesforce data model represents accounts—companies and organizations involved with your business, such as customers, partners, and competitors.")