Archiving and Deleting

How to archive and permanently delete boards and tasks in AgentKanban.

Overview

AgentKanban provides two ways to remove items you no longer need:

• Archive -- hides the item from view but keeps it recoverable. Use this when you might want it back later.
• Delete -- permanently removes the item. This cannot be undone.

Boards and tasks each support both actions. For boards, both archiving and deleting require you to type the board name to confirm. For tasks, a simpler confirmation dialog is shown.

Archiving boards

Archiving a board hides it from the board list and from API results. The board's data is preserved and can be restored later.

From the board list

1. Go to Boards
2. Hover over the board card
3. Click the archive icon (amber box icon)
4. Type the board name exactly as shown to confirm
5. Click Archive board

Archived boards do not count against your active boards quota.

Deleting boards

Deleting a board permanently removes it and all its tasks, turns, and API keys. This cannot be undone.

From board settings

1. Open the board you want to delete
2. Click the gear icon to open board settings
3. Select the Danger tab
4. Click Delete this board
5. Type the board name exactly as shown to confirm
6. Click Delete board

Archiving tasks

Archiving a task hides it from the board view. The task data remains in the board and can be restored later.

From the board view

1. Hover over the task card in its lane
2. Click the archive icon (amber box icon)
3. Confirm the action in the dialog

From the task detail page

1. Open the task by clicking on it
2. Click the Archive task button
3. Confirm the action in the dialog

You are redirected back to the board after archiving from the detail page.

Deleting tasks

Deleting a task permanently removes it from the board. This cannot be undone.

From the board view

1. Hover over the task card in its lane
2. Click the delete icon (red trash icon)
3. Confirm the action in the dialog

From the task detail page

1. Open the task by clicking on it
2. Click the Delete task button
3. Confirm the action in the dialog

You are redirected back to the board after deleting from the detail page.

Confirmation dialogs

All archive and delete actions show a confirmation dialog before proceeding.

• Boards use a type-to-confirm dialog -- you must type the board name exactly to enable the confirm button. This prevents accidental archiving or deletion of boards.
• Tasks use a simple confirm dialog -- click the confirm button or press Escape / Cancel to dismiss.

API support

Both the internal and External API support board archiving via the PATCH endpoint:

PATCH /api/ext/v1/boards/{boardId}
Content-Type: application/json

{ "archived": true }

Set archived to false to restore a board. Archiving requires edit permission on the board.

Archived boards are excluded from the GET /api/ext/v1/boards listing by default.

Entitlements and quotas

Archived boards and their tasks do not count against your plan's active boards or active tasks limits. Archiving boards you are not currently using is a good way to stay within your quota without losing data.