---
title: "Delete Table"
method: DELETE
path: "/api/public/v2/tables/{table_id}"
tags: ["smart-tables"]
---

# Delete Table

`DELETE /api/public/v2/tables/{table_id}`

Delete a Table. This soft deletes the table and removes it from active list responses. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

## Path parameters

- `table_id` string, uuid, required

## Response `200`

Table deleted

- object
  - `success` boolean
  - `message` string

## Other responses

- `401` — Unauthorized - missing or invalid API key.
- `403` — Workspace access denied or missing delete permission
- `404` — Table not found
- `422` — Validation error - request parameters or body are invalid.
- `500` — Failed to delete table

---

[API](https://skmtc.dev/promptlayer/apis/promptlayer-api.md) · [All operations](https://skmtc.dev/promptlayer/apis/promptlayer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/promptlayer/promptlayer-api/revisions/a23093a0a506/schema)