---
title: "Delete a workspace"
method: DELETE
path: "/workspaces/{workspace_id}"
tags: ["Organization"]
---

# Delete a workspace

`DELETE /workspaces/{workspace_id}`

Delete a workspace and everything in it, including its tests, plans, runs and run history. The workspace stops being accessible immediately and cannot be restored through the API; contact mabl support if a deleted workspace needs to be recovered. Deleting a workspace never unsubscribes its billing account: a request to delete the last remaining workspace in an account is refused, and closing an account is not a public operation. Available to workspace owners, company owners, and properly permissioned API keys.

## Path parameters

- `workspace_id` string, required

## Response `204`

The workspace was deleted

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Workspace not found
- `409` — The workspace is the last one in its billing account, so deleting it would unsubscribe the account
- `default` — Unknown error

## Changes

- **2026-09-01** `2938d8f6f737` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mabl/apis/mabl-api/changes/workspaces/:workspace_id/delete.md)

---

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