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

# Delete a workspace

`DELETE /v3/workspaces/{workspace_id}`

Deletes the specified workspace. You can't delete the application's default workspace. The workspace's grants keep working and move to the default workspace, or become unassigned if there isn't one.

To learn what gets removed and when, see [Deleting resources and data](/docs/dev-guide/platform/deleting-resources/).

## Response `200`

Delete Succeeded

- object
  - `request_id` string, required — ID of the request.

## Other responses

- `400` — Error: Bad request. The workspace is the application's default workspace, which can't be deleted.
- `401` — Error: Not authenticated
- `404` — Error: Not found

---

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