Tasks

In awork you can organize your work with Tasks. In general a task can have one of two types.
Project tasks are the workload of a project with which you can plan. They follow a status workflow that you can define yourself. They are only “valid” if the project is in a status of a phase that is “in progress” and is therefore visible to the project members.
Private tasks are your personal to-dos. They also follow a status workflow that you can define yourself.

Smart task lists

Smart lists are custom filters regarding tasks that filter entities (Users, Projects, Tasks) or their specific properties (Statuses, Types, Tags). Users can share their smart lists by setting the IsShared property to true. When a smart list is shared, other users in the team either subscribe to or unsubscribe from it. Only the user who created the smart list has the permission to edit/delete it. If you are editing a shared smart list, you edit the filter for all users who have subscribed to the smart list.

Type of Work

With a Type of Work, you define the type of work for a task. A Type of Work is also used when you record your times. It will automatically use the same type of work as in the task, but you can also change it. It is possible to create any number of Types of Work.

Task Statuses

A task status defines a specific step that a task can go through. In general, a task status can be divided into four categories:

  • To do
  • In progress
  • Done
  • Stuck

For private tasks, four predefined task states are available to you. A task status of each category. The situation is different with Project Tasks. A task status belongs to a project, so a project task can also accept any task status from this project. In a project, you can create as many task statuses as you like. The important thing is, there must always be a status in the category ‘To do’ and ‘Done’.

Task Lists

A task list is a project-related grouping mechanism for tasks. They can be created manually or by templates. Tasks within a project can be in several lists in the same project. Users can also have private lists, in which case a task list is linked to a user id.

Task List Filters

You can filter your tasks on a wide variety of options. For example,
• based on task types
• based on timeline (Cont., Weekly and Monthly)
• based on the members of your project team
• based on done status
• based on priority
• based on due date
• based on the input filter query which the user has typed

Task Bundles

The task bundles are sets of predefined tasks and lists that can be added to a project. The user has the option to import a template for a project or assigning it to the project when it is created (if the task bundle is assigned to that particular project type).

Task Templates

Task templates contain basic details to create tasks of it.

Task List Templates

Task list template is basically a task list that can be added to a project. It contains multiple task templates that will create tasks in the project when added.

Permissions

The permissions needed to work with tasks depend on the task type. Secondly, whether the user is also the task’s assignee.
Regardless of the type of task, a user always has the right to edit a task if he or she is also assigned to the task.

Users who want to see and edit project tasks, but are not assigned, need permissions for the feature project-planning-data.
Only the assignee or owner has access to private tasks.

If you want to try out these endpoints, click the following button and get all the endpoints as a collection for Postman.