Nurama Developers
Boards

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`.

DELETE
/boards/{boardId}

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.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

boardId*string

Unique identifier of the board

Formatuuid

Request 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"  ]}