---
title: "Trash or delete a board"
method: DELETE
path: "/boards/{boardId}"
tags: ["Boards"]
---

# Trash or delete a board

`DELETE /boards/{boardId}`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/boards/{boardId}`
- Auth: HTTP bearer

On Plus and Max the board goes to the trash for 30 days. Basic has no trash: the board is
deleted for good, and the call insists on `?permanent=true` so that cannot happen by
accident. `?permanent=true` also empties a board out of the trash on any plan.

## Query parameters

- `permanent` boolean

## Response `204`

Trashed, or deleted for good.

## Other responses

- `409`: Basic without permanent=true, or the board is already in the trash.
- `429`: Too many requests.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)