Delete a board
Deletes a board and its columns. The optional body controls what happens to tasks on the board: - `unassign` (default) — set `boardId` and `columnId` to null on each task. Tasks are kept. - `delete` — delete every task on the board, plus its TaskRelation, TaskLink, and TaskEvent rows. - `reassign` — move tasks to `targetBoardId` / `targetColumnId` (defaults to the target's default column). If the target column has a `taskStatus`, the task's `status` is updated to match. For `reassign`, the caller must also have Update access on the target board's tasks (`targetBoardRequired` when `targetBoardId` is missing, `targetBoardSameAsSource` when it equals the board being deleted). Requires `canDelete{Creator|Reviewer}Board`.
Deletes a board and its columns. The optional body controls what happens to tasks on the board:
unassign(default) — setboardIdandcolumnIdto null on each task. Tasks are kept.delete— delete every task on the board, plus its TaskRelation, TaskLink, and TaskEvent rows.reassign— move tasks totargetBoardId/targetColumnId(defaults to the target's default column). If the target column has ataskStatus, the task'sstatusis updated to match.
For reassign, the caller must also have Update access on the target board's tasks
(targetBoardRequired when targetBoardId is missing, targetBoardSameAsSource
when it equals the board being deleted). Requires canDelete{Creator|Reviewer}Board.
Authorization
bearerAuth In: header
Path Parameters
Unique identifier of the board
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/boards/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{ "message": "string", "disposition": "unassign", "deletedTaskIds": [ "5563cfe8-4b91-4c67-9431-8019b3332db4" ], "reassignedTaskIds": [ "06e733d8-b9d6-42a7-ab81-ad000d62aa1b" ]}