---
title: "Delete a workspace"
method: DELETE
path: "/workspaces/{workspaceId}"
---

# Delete a workspace

`DELETE /workspaces/{workspaceId}`

## Request

- Base URL: `https://api.tally.so`
- URL: `https://api.tally.so/workspaces/{workspaceId}`
- Auth: HTTP bearer

Deletes a workspace and all its associated forms. The workspace and forms are moved to trash and can be restored later. Forms in DRAFT or PUBLISHED state will be marked as DELETED.

## Path parameters

- `workspaceId` string, required

## Response `204`

Workspace successfully deleted

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - User doesn't have required permissions or Pro subscription
- `404`: Workspace not found

---

[API](https://skmtc.dev/tally/apis/tally-api.md) - [All operations](https://skmtc.dev/tally/apis/tally-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tally/apis/tally-api/revisions/8b37e41e11fa?raw)