---
title: "Move a table to Trash"
method: DELETE
path: "/tables/{table_id}/"
tags: ["tables"]
---

# Move a table to Trash

`DELETE /tables/{table_id}/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/tables/{table_id}/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Move a table to Trash. Nothing is destroyed: its columns, rows and cells all stay, the table simply stops appearing anywhere except the Trash listing, and it can be restored in full.

The table's name is freed immediately, so the same name can be reused at once. A retention sweep destroys trashed tables for good once they are old enough.

## Path parameters

- `table_id` string, uuid, required

## Response `200`

Successful Response

- SuccessfullyDeletedResponse
  - `count` integer: The number of resources that were deleted.
  - `detail` string, required: The detail of why the resource was deleted.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Table not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)