---
title: "Delete a table view"
method: DELETE
path: "/api/v1/table-views/{id}"
tags: ["Views"]
---

# Delete a table view

`DELETE /api/v1/table-views/{id}`

## Request

- Base URL: `https://api.recruitwithatlas.com`
- URL: `https://api.recruitwithatlas.com/api/v1/table-views/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/recruitwithatlas/apis/atlas-api/docs/api/v1/table-views/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Soft-deletes the view and closes the gap it leaves in its owner's ordering. Only the owner can delete a private view; on a shared view an agency admin can too. Collaborators cannot — deletion is irreversible through the API.

## Path parameters

- `id` string, uuid, required: Table view ID

## Response `200`

Table view deleted

- object
  - `status` 'ok', required
  - `id` string, uuid, required

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `403`: The view is visible to you, but you may not change it — only the owner, or an agency admin on a shared view
- `404`: The view does not exist, belongs to another agency, or is not visible to you
- `422`: Validation error - the request failed schema validation (`errors.fieldErrors`) or a business rule (`errors.formErrors`)
- `429`: Too many requests - the caller has exceeded the per-agency rate limit for the tier this endpoint counts against (default per minute: 1200 read / 400 write / 60 upload). Inspect the `RateLimit-*` headers — returned on every response, not only on 429s — and back off until the window resets. See the "Rate limits" section of the introduction for details.
- `500`: Internal server error
- `501`: Endpoint is disabled in this environment. Not a routing error — do not retry.

## Changes

- **2026-10-07** `0c873956b881`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/recruitwithatlas/apis/atlas-api/changes/api/v1/table-views/:id/delete.md)

---

[API](https://skmtc.dev/recruitwithatlas/apis/atlas-api.md) - [All operations](https://skmtc.dev/recruitwithatlas/apis/atlas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitwithatlas/apis/atlas-api/revisions/158ee454751c?raw)