What are Tasks?
Found this helpful? Share it:
Found this helpful? Share it:
Tasks give your workspace a shared tracker, from a quick to-do to a multi-step project. You group tasks into Tasks Lists, and everyone in the workspace works the same board together 📋
A task is a single piece of work. It has a title, a status, and a priority, plus optional details: a description, one or more assignees, a start date, a due date, and labels.
You can also break a task into sub-tasks, mark it blocked by or a duplicate of another task, and talk it through in comments. See Organize related work and Track and collaborate.
A task moves through seven statuses:
Backlog: captured, not yet planned.
Todo: planned and ready to start. This is the default for a new task.
In Progress: someone is working on it.
In Review: done and waiting on a check.
Done: finished.
Cancelled: dropped without finishing.
Duplicate: the same work as another task.
Priority runs from No priority(the default) through Low, Medium, High, and Urgent.
Every task lives inside a Tasks List, one per project, team, or area. Your workspace can hold as many lists as you need, and each list holds up to 20,000 tasks.
When you create a list you give it a Tasks Prefix: up to six uppercase letters or digits. Leave the field blank and idapt derives one from the name. The prefix is the front half of every task id in the list.
Each task id is the list's prefix plus a number, like OR-123. Numbers count up as you add tasks and are never
reused, and each id is unique across your workspace. Drop OR-123 into a chat, a comment, or a message and everyone
knows exactly which task you mean.
Changing a list's Tasks Prefix rewrites the displayed id of every task
in it. The task numbers stay the same, so OR-123 becomes NEW-123.
Open the three-dot List actions menu in the list's breadcrumb to rename a list, change its prefix, or delete it.
Deleting a Tasks List moves it to the trash rather than destroying it, and the tasks it holds are kept, not erased. The list simply leaves your workspace. You can restore it from Trash.
Access follows your role in the workspace:
Anyone in the workspace can see the board and open tasks.
Editors, admins, and owners can create tasks, change them, comment, and manage lists.
Viewers have read-only access.
Assignees are always people, so you can only assign a task to a member of the list's workspace. Agents help with tasks but are never assignees. See Members and roles.
Your own changes appear the moment you make them, and your open tabs stay in sync with each other, so the board you left in one tab matches the one you come back to in another.
Everything on the board is also available through the idapt API, the command line, and your agents, so you can create, update, and query tasks from a script or a conversation. See the API reference.
Related articles
Create and edit tasks
Add tasks fast, set status and priority, assign teammates, add dates and labels, and edit anything in place.
Organize related work
Break a task into sub-tasks, mark one blocked by another, and point duplicates at a single source of truth.
Track and collaborate
Filter and sort the board, search across lists, discuss in comments, follow the activity timeline, and bring an agent in.
Was this helpful?