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

# Delete Sheet

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

Delete a sheet. This soft deletes the sheet and removes it from active sheet 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
- `sheet_id` string, uuid, required

## Response `200`

Sheet deleted

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

## Other responses

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

---

[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)
