Docs: Tool reference
admin toolset

delete_board

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

FieldTypeDescription
boardrequiredstringThe board's ID (brd_…), slug or name.
move_posts_tostringBoard to move this board's posts to. Required when the board has posts.
expected_versionintegerThe board's version from your last read. If it changed since, the call fails instead of overwriting a newer change.
confirmbooleanMust be true to perform this destructive action, unless dry_run is true.
dry_runbooleanPreview the result without changing anything.

Output

FieldTypeDescription
deletedrequiredobject
categories_deletedrequiredarray of object
moved_torequiredobject or null
posts_movedrequiredinteger
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "delete_board", "arguments": {"board":"<string>"} }

// Typed client
await carechannel.delete_board({"board":"<string>"});