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

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: tasks:write

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