Delete a board. Deletes a board and its categories; its portal page disappears. If the board has posts, move_posts_to (another board) is required; moved posts lose their category. The only board can't be deleted while it has posts. Destructive: pass confirm: true, or dry_run: true to preview the counts. Managers and owners. Nobody is emailed.
Toolset
admin
Who can call it
OwnersManagersAPI keys
REST
DELETE /api/v1/w/{workspace}/boards/{board}
Behavior
changes datadestructive (confirm: true, dry_run)
Input
Field
Type
Description
boardrequired
string
The board's ID (brd_…), slug or name.
move_posts_to
string
Board to move this board's posts to. Required when the board has posts.
expected_version
integer
The board's version from your last read. If it changed since, the call fails instead of overwriting a newer change.
confirm
boolean
Must be true to perform this destructive action, unless dry_run is true.