Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bytestream.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Projects hold execution work. Tasks are the units that move across board and list views.

Task fields

Tasks can include:
  • Title and Markdown description
  • Status
  • Priority
  • One or more assignees
  • Project, team, milestone, and labels
  • Start date and due date
  • Dependencies
  • Subtasks
  • Attachments
  • Recurrence

Statuses

Default statuses are:
StatusMeaning
backlogNot ready for active work
todoReady to pick up
in_progressActively being worked
doneCompleted
cancelledClosed without completion
Projects can define custom board columns. The API accepts the project’s configured status values, and cancelled is always valid.
The current CLI validates --status against the default set: backlog, todo, in_progress, done, and cancelled. Use the API for custom project statuses until CLI support is added.

Priorities

ValueLabel
0Urgent
1High
2Medium
3Low

Assignees

Tasks support multiple assignees. Use one assignee when ownership is clear. Use multiple assignees for collaborative work where all participants need notifications and visibility.

Dependencies

Dependencies express blocking relationships. A task can be blocked by another task or can block another task. Use dependencies when task order matters:
Design approval -> Landing page implementation -> Launch announcement
Atoll rejects circular dependencies and duplicate dependency links.

Recurring tasks

Recurring tasks can repeat daily, weekly, monthly, or yearly. When a recurring task is marked done, Atoll creates the next instance based on the recurrence interval.

Archive before delete

Archive tasks when you want reversible removal from active lists. Permanent delete is restricted to owners/admins and should be used sparingly.
atoll issue archive ATOLL-42
atoll issue unarchive ATOLL-42