Skip to main content
Tasks are the unit of work in TaskFlow Pro. Each task belongs to a project, is assigned to a team member, and moves through a defined set of statuses until it is complete.

​
What is a task?

Each task contains the following information:
FieldDescription
TitleA short description of the work to be done
DescriptionFull details of the task
PriorityThe urgency level (see below)
Due dateThe deadline — must be today or a future date
StatusCurrent stage in the workflow
Assigned toThe team member responsible for the task
ProjectThe project this task belongs to

​
Priority levels

When creating or editing a task you must choose a priority. The field is free-text, but the conventional values used in TaskFlow Pro are:
  • alta — high priority
  • media — medium priority
  • baja — low priority
Use consistent priority labels across your team so that task lists sort and filter predictably.

​
Task workflow

Every task starts in TODO and advances through the following states: 
TODO → IN_PROGRESS → IN_REVIEW → DONE
The Tasks page displays a Kanban-style board with one column per status. Your tasks are grouped automatically as their status changes.

​
Typical task lifecycle

1

Task created (TODO)

An Admin or PM creates the task, assigns it to a Developer, sets the priority and due date, and links it to a project. The task appears in the TODO column.
2

Work begins (IN_PROGRESS)

The assigned Developer — or an Admin/PM — moves the task to IN_PROGRESS to signal that active work has started.
3

Ready for review (IN_REVIEW)

Once the Developer finishes, the task moves to IN_REVIEW. An Admin or PM can also push a task into review directly.
4

Completed (DONE)

An Admin or PM marks the task DONE after the review passes. The task is complete.

​
Who can move tasks?

State transitions are role-sensitive:
TransitionDeveloperAdmin / PM
TODO → IN_PROGRESSOwn tasks onlyAny task
IN_PROGRESS → IN_REVIEWOwn tasks onlyAny task
IN_REVIEW → DONE—Any task
Developers can only change the status of tasks assigned to them. Attempting to update another user’s task returns a 401 error.

​
Creating a task

Only Admins and PMs can create tasks. From the Projects page, click Nueva tarea on any project card. Fill in all required fields:
  • Title
  • Description
  • Priority
  • Due date (cannot be in the past)
  • Assigned user
The task is created with a status of TODO and immediately appears in the assigned user’s task board.

​
Viewing tasks

The Tasks page (/tasks) shows all tasks assigned to you, grouped into four columns: TODO, IN_PROGRESS, IN_REVIEW, and DONE.Only tasks belonging to active (non-archived) projects are shown.

​
Editing a task

Only Admins can perform a full edit on a task. Editable fields are:
  • Title
  • Description
  • Priority
  • Due date
Task assignment (assigned_to) and project cannot be changed after creation. To reassign a task, an Admin must delete it and create a new one.

​
Deleting a task

Both Admins and PMs can delete tasks. Deletion is permanent.
The frontend does not currently include task filter or search controls. Filtering by status, priority, or assignee is a planned feature for a future release.

Build docs developers (and LLMs) love

Get started for freeTalk to us