---
title: "Task objects"
canonical: "https://support.appfire.com/space/CDML/649793989/Task%20objects"
format: markdown
---
> Macro (aura-html)


## Overview

Task objects can be retrieved via:

- `tasks` key (list of all incomplete tasks for the workflow) on Confluence page and news (blog post) objects – for mode details see [Workflow Supplier](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726882)
- `tasks` or `activetasks` keys (list of all incomplete tasks) on [State objects](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957742)
- `completedtasks` key (list of all complete tasks) on [State objects](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957742)
- `alltasks` key (list of all tasks, complete and incomplete) on [State objects](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957742)

## Supported keys

| Key | Content Types | Return Type | Description |
| --- | --- | --- | --- |
| `name` | Task | [Text](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035980) | Current name of the task<br>See: **[task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819)**[ macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819), [Create a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759190), [Edit a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563090) |
| `user` | Task | [User](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036252) | User who created the task (if applicable)<br>See: **[task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819)**[ macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819), [Create a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759190) |
| `date` | Task | [Date](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036151) | Date on which the task was created<br>See: **[task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819)**[ macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819), [Create a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759190) |
| `duedate` | Task | [Date](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036151) | Date on which the task is set to expire<br>See: [Expiry Dates](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890606), **[task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819)**[ macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819), [Task expiry date](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661544) |
| `comment` | Task | [Text](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035980) | Description associated with the task<br>See: **[task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819)**[ macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315819), [Create a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759190), [Edit a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563090) |
| `assignee` | Task | [User](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036252) | Most recent user assigned to the task<br>See: [Assign a task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649792357) |
| `assignment` | Task | **[Task Assignment](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650219059)** | Most recent task assignment object |
| `assignments` | Task | [List](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035989) of **[Task Assignment](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650219059)** | A list of all task assignment objects (for example, if the task was reassigned) |
| `completion` | Task | **[Task Completion](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957926)** | The most recent task completion object |
| `completions` | Task | [List](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035989) of **[Task Completion](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957926)** | The list of completions, if say the Task is completed, re-opened, and completed again |
| `completed` | Task | [Boolean](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036140) | Is the task completed? |

## Related pages

> Macro (children)

| [‹ Back to State objects](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957742) |
| --- |
| [‹ Back to Workflow Supplier](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726882) |