# Delete a board

> Delete a board. This will not delete the generations made on it.

Canonical page: https://www.rundiffusion.com/docs/api/boards/delete
Endpoint: DELETE /api/v2/boards/{board_id}
Authorization: OAuth device flow or Personal API Access Token or Company API Access Token

---

Deletes the board itself. Deleting takes more than edit access, so a caller who
can rename a board cannot always remove it.

`DELETE /api/v2/boards/{board_id}`

Authorization: OAuth device flow or Personal API Access Token or Company API Access Token

## Who can delete a board

Only the board's owner, or a holder of **Can manage everyone's generations and
boards** (`MANAGE_ALL_GENERATIONS`).

> **Deleting takes more than edit access**
>
> **Can manage Shared assets** (`SHARE_ASSETS`) lets you curate a shared
> board, not destroy it. It is enough to rename that board and change what is on
> it, and it is not enough to delete it, so a caller whose
> [Edit a board](/docs/api/boards/update) succeeds can still get
> `403 PERMISSION_DENIED` here.

## Request

**Headers**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Authorization` | string | Yes | Bearer token. This endpoint accepts an OAuth device flow token, a Personal API Access Token, or a Company API Access Token. See [Authentication](/docs/api/authentication). |

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `board_id` | string | Yes | The board to delete. |

cURL:

```bash
curl -X DELETE https://api2.rundiffusion.com/api/v2/boards/$BOARD_ID \
  -H "Authorization: Bearer $RUNDIFFUSION_TOKEN"
```

JavaScript:

```javascript
await fetch(`https://api2.rundiffusion.com/api/v2/boards/${boardId}`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.RUNDIFFUSION_TOKEN}`,
  },
});
```

Python:

```python
requests.delete(
    f"{BASE}/boards/{board_id}",
    headers=HEADERS,
)
```

## Response

`204 No Content`. The board stops appearing in
[List boards](/docs/api/boards/list) and answers `404 BOARD_NOT_FOUND`
afterwards.

Generations made on it are not deleted and stay in
[Library](/docs/api/library/list). They keep the `board_id` of the deleted board,
so a saved filter still finds them.

## Errors

**Status codes**

| Name | Type | Description |
| --- | --- | --- |
| `401` | TOKEN_INVALID | Missing or invalid credential. |
| `403` | PERMISSION_DENIED | You can see the board but may not delete it. Editing is the looser rule, so this can happen where the same caller's edit succeeds. |
| `404` | BOARD_NOT_FOUND | No such board, or not one this credential can see. |
| `429` | RATE_LIMITED | Too many requests. Board writes have a tighter budget than reads. See [Rate limits](/docs/api/rate-limits#boards). |