---
title: "Delete a table and its rows"
description: "Drops the table and every row in it, with the link fields on other tables that pointed at it, and removes it from every rule that named it."
canonical: "https://gtable.app/docs/builder-api/tables/delete"
updated: "2026-10-05"
---

# Delete a table and its rows

`DELETE https://studio.gtable.app/v1/apps/{appId}/tables/{tableId}`

Drops the table and every row in it, with the link fields on other tables that pointed at it, and removes it from every rule that named it.

Its rows, its links and its grants go to the app's trash for thirty days first, so trash.restore can put the whole table back with the same ids. Refused with the list of what reads it (409, details.impact) until you send acknowledge=true. Send the table's current name as `confirm`.

Requires the `schema:write` scope. Operation `tables.delete`. MCP tool `tables_delete`. CLI, once published: `gtable tables delete`.

## Path parameters

| Name      | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| `appId`   | string | yes      |             |
| `tableId` | string | yes      |             |

## Query parameters

| Name          | Type    | Required | Description           |
| ------------- | ------- | -------- | --------------------- |
| `confirm`     | string  | no       | Up to 200 characters. |
| `acknowledge` | boolean | no       |                       |

## Headers

| Name              | Type   | Required | Description                                                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Idempotency-Key` | string | no       | Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |