---
title: "Delete a table"
method: DELETE
path: "/v1/tables/{id}"
tags: ["tables"]
---

# Delete a table

`DELETE /v1/tables/{id}`

Delete a table. By default, documents in the table are moved to the default table. Set `cascade=true` in the request body to delete all documents in the table.

## Path parameters

- `id` string, required

## Request body

- DeleteTableRequest
  - `cascade` boolean — If true, delete all documents in the table. If false, move them to default table.

## Response `200`

Table deleted

- object
  - `deleted` boolean
  - `id` string
  - `cascade` boolean

## Other responses

- `400` — Cannot delete default table
- `404` — Table not found
- `500` — Failed to delete table

---

[API](https://skmtc.net/brainfish-ai/apis/reasondb-api.md) · [All operations](https://skmtc.net/brainfish-ai/apis/reasondb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brainfish-ai/reasondb-api/revisions/f8665c1a5239/schema)