Apiboo documentation

DocsTeam & planning

Boards

Lists, tasks, labels and comments, and sharing a task to chat.

Boards

Boards are Apiboo's task manager: lists of task cards you move from left to right as work gets done. A board is either private (yours) or a team board that every member of the team sees and edits live.

Open Task Manager on the rail. The Boards tab shows a tile for every board.

Create a board

  1. Click the New board tile. The Create board modal opens.
  2. Choose the Visibility:

    • Private: only you.
    • Team: owned by the team and live for all its members. You need to be an editor, admin or owner on a team to pick it.
  3. Enter a Name, for example "Bookshop API", and an optional Description.
  4. Pick a Color (New random gradient rolls another one).
  5. Add Labels now or later (see Labels).
  6. Show completed tasks decides whether tasks marked done stay visible.
  7. Click Create.

A new board starts empty. Click + Add list to make your first column.

On the Boards tab, Filter boards… (Ctrl/Cmd+F) narrows the tiles. Hover a tile for Edit board, Delete board, Share with team and, for private boards, Move to cloud / Move to this device.

Lists

  • + Add list adds a column and puts its name straight into edit mode.
  • Click a list's title to rename it.
  • The list's ⋯ menu has Rename and Delete. Deleting a list deletes its tasks.
  • Drag a list by its header to reorder the columns.

Tasks

A Bookshop board in Kanban view: three lists, cards with priority dots, due dates, label chips and an assignee
  1. Click + Add Task at the bottom of a list.
  2. Type the title and press Ctrl/Cmd+Enter to save it (Esc cancels). In the List view, Enter saves.
  3. Drag the card to another list, or up and down within one. Dropping a card on + Add list creates a new list with the card in it.

On a card:

ControlWhat it does
The circleMark as done / Mark as not done
The priority dotClick to cycle Low → Medium → High
Due dateShown on the card; red when it is overdue
Label chipsThe task's labels
AvatarThe assignee (team boards)
Send to chatTeam boards: send the task to a teammate (see Send a task to chat)
Edit, DeleteOpen the task, or delete it

The board's toolbar switches between Kanban and List view, and has Undo (Ctrl+Z) and Redo (Ctrl+Shift+Z or Ctrl+Y). On a team board, the avatars of teammates looking at the same board appear there.

Task details

Click a task's title to rename it right on the card. To open the task, use the pencil button (Edit) on the card. The window is one column:

The task window: the title with its dates under it, the … menu and the close button beside it, chips for In progress, High, the due date and Labels, the description with a list, a comment from Maya, and at the bottom the comment box
  • At the top: the title — click it to rename — with when the task was created and last updated under it. On the right, … holds the actions and the × beside it closes the window:

    • Copy link copies a link to the task (apiboo://boards/…/tasks/…). Opening it opens the board with the task, on any of your devices; an AI agent can read it too.
    • Send to chat (team boards) sends the task to a teammate (see Send a task to chat).
    • Move to › opens your lists; pick one to move the task to its end.
    • History, once your boards are in a repository (see History and restore).
    • Delete task.
  • A row of chips, each a menu: status (To do, In progress, Done, Dismissed), priority (Low, Medium, High), due date, and on team boards the assignee and the Owner (point at a person chip to see which one it is). Labels shows how many the task has and opens the board's labels to tick on or off — the card on the board shows them — and typing a new name there creates it (Create "…" or Enter) and ticks it for this task. To mark a task done, set its status to Done.
  • Description: a rich editor, the same one as in Documents. Type / for headings, lists, code, tables, images and YouTube or Vimeo videos (see Slash commands).
  • Comments, newest last. At the bottom, write in Add a comment… and send with Ctrl/Cmd+Enter. On a team board, type @ to mention a teammate. Each comment has Delete. A comment you typed and did not send is kept as a draft: close the task, open it again, and it is still there until you send it or close Apiboo.

Changes save as you go. Esc or a click outside the window closes it.

Labels

Labels belong to a board. Open Board settings (the gear in the toolbar):

  1. Type a name in New label… and click Add label.
  2. Pick its colour: gray, red, amber, green, blue or purple.
  3. Rename a label in place, or remove it with its ×.

Filter a board

The filter bar above the lists narrows the cards:

FilterShows
Search tasks…Tasks whose text matches
MineTasks assigned to you (team boards)
OverdueTasks past their due date
UnassignedTasks with no assignee (team boards)
A label chipTasks with that label. Several labels show tasks with any of them.

It shows how many tasks match, for example "4 of 12". While a filter is on you can't reorder cards ("Reordering off while filtered"); Clear turns the filters off.

Team boards

A team board is stored in the cloud and updates live for everyone on the team. Share with team on a private board's tile moves it to a team: it asks you to pick the team and says the board "will move to the team and become realtime for all members". Team viewers see a View only badge and can't change anything.

Send a task to chat

On a team board, Send to chat on the card, or under … in the task's window, opens Send task to a teammate. It lists the people on this team you already have a direct message with; pick one and the task is sent as a card. Only they can read it, and only if they are on the team. They click the card to open the task right in the chat. See The task quick view.

Boards and AI agents

With the Boards permission on the MCP Server, an AI agent can read your boards to see what is in progress and what is blocked, and, with the write grant, create boards and lists, add, update and move tasks and comment. It can't set labels or assignees. See How MCP helps an AI agent.