---
title: "Delete an archived workspace with its dashboards, reports and Net Zero (tenant admins; typed confirmation)"
method: POST
path: "/workspaces/{workspaceId}/delete"
tags: ["Workspaces"]
---

# Delete an archived workspace with its dashboards, reports and Net Zero (tenant admins; typed confirmation)

`POST /workspaces/{workspaceId}/delete`

The workspace must be archived and confirmName must equal its name exactly. A legacy Net Zero
target, or a target set of another workspace or of All data, on one of its baselines refuses
the delete. In one transaction its target sets, manual inventories, baselines, reports,
dashboard generations and layouts are deleted, then the workspace; its grants go with it and
assistant threads fall back to All data. Emission data, sites and entities are never touched.
The default "All data" is never deletable.

## Request body

- WorkspaceDeleteRequest
  - `confirmName` string, required — The workspace's name, typed exactly

## Response `204`

Deleted

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — DEFAULT_WORKSPACE; WORKSPACE_NOT_ARCHIVED; WORKSPACE_BASELINE_IN_USE: a legacy Net Zero target, or a target set outside the workspace, uses one of its baselines
- `422` — CONFIRMATION_MISMATCH: confirmName is not exactly the workspace's name

## Changes

- **2026-10-02** `766c2a40e369` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/workspaces/:workspaceId/delete/post.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/4189686230ca?raw)