Tasks

A task has several arguments. It contains a text describing what the assigned users or roles should do, it contains an ID which is used to identify the task in any command, and it has one of three states. It can optionally contain a deadline.

Task Data

ID*
Text
State
Creator*
Creation Date*
Deletion Date**
Deadline
Repeat interval
Next repeat date
Repeat end date
Assigned User(s)
Assigned Role(s)

*The ID, creator and creation date are fixed values that can't be changed.

**The deletion date is set when the task is marked as deleted by executing the task delete command.

States

Each task is located in one of the states:

Todo - The state with which each task starts. It means that no one has started working on the task.
In Progress - This state means that someone has started working on the task.
Done - The last state means that the task has been completed.

Deadline

The deadline is set by executing the task deadline command.

Repeating Tasks

Tasks can be set to be repeated. This means the task will be moved to the Todo state after it has been completed and the interval has passed. The interval can be set to a specific amount of dates, between 1 and 365.

Once the interval is reached, the task will be checked if it has been completed. If it has, it will be moved to the Todo state. If it hasn't, the task will not be moved, but the next check will happen after the set interval. This process will repeat until the repeat end date is reached. If no repeat end date is set, the task will repeat forever.

In all lists, a repeating task will be marked with a 🔁 symbol.

Task Commands

/task create

text

My task text

assignee

@User

project

default

deadline

10/30/2023 09:00

repeat_days

This command creates a new task. The task will get a random id and the given text will be linked to it. The author of the command can assign the task to a role or user, but tasks without an assignee can be created too. A project can be specified to create the task in the given project. If this option is not set the task will be created in the users selected project. If repeat_days are set, the task will be moved back into the todo state after the given amount of days, when it has reached the done state.

Required permission: MANAGE_TASKS

/task assign

task_id

12345

assignee

@User

This command adds a new assignee to the specified task. Roles and users can get assigned to a task. There can be a maximum of 15 assignees per task, counting users and roles.

Required permission: ASSIGN_TASK

/task unassign

task_id

12345

assignee

@User

This command removes an assignee from a task.

Required permission: UNASSIGN_TASK

/task info

task_id

12345

Provides detailed information about the task.

/task proceed

task_id

12345

Pushes the status of the task in the next state (from "ToDo" to "In Progress", from "In Progress" to "Done").

/task done

task_id

12345

Sets the status of the task with the given id to done.

/task undo

task_id

12345

Pulls the status of the task to the previous state (from "Done" to "In Progress", from "In Progress" to "ToDo").

/task edit

task_id

12345

text

My new task text

Allows the command author to change the task text.

Required permission: EDIT_TASKS

/task list

project

default

assignee

@User

filter

IN_PROGRESS

Displays all tasks assigned to the specified assignee. If no assignee is specified, your tasks will be displayed. The "filter" option can be used to display only tasks with a specific status. If the "project" option is set, the tasks inside the specified project will be displayed.

/task project

project

default

filter

IN_PROGRESS

Displays all tasks inside a selected project. If no project is specified in the command, it will list all tasks across all projects. The filter option allows to filter tasks by status.

/task move

task_id

12345

project

default

Moves a task to a different project.

Required permission: MANAGE_TASKS

/task deadline

task_id

12345

deadline

12/31/2024 23:59

Sets the deadline of a task. If no deadline is set the deadline will be removed from the task. The deadline can be set to a date or as a relative date (e.g. 1 day 2 hours) or in a relative short form (1w2d).

Required permission: MANAGE_TASKS

/task delete

task_id

12345

Move task to recycle bin. Tasks moved to the recycle bin are permanently deleted after 30 days.

Required permission: MANAGE_TASKS

/task restore

task_id

12345

Restores a deleted task that was previously moved to the Recycle Bin.

Required permission: MANAGE_TASKS

/task repeat

task_id

12345

repeat_days

repeat_end

5 weeks

Makes the task repeatable. If the repeat_days option is set, the task will be repeated every x days. This means the task will be moved back into the todo state when it reached the done state after the repeat interval is reached. If the option is not set, the task will not be repeated. If repeat_end is specified, the task will be repeated until the given date. This can be set to a date or as a relative date (e.g. 1 week 2 days) or in a relative short form (1w2d).

Required permission: MANAGE_TASKS

All commands Projects