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

# Delete Workspace

`DELETE /v3/workspaces/{workspace_id}`

Delete a Workspace. This accepts the deletion request and processes it in the background,
permanently deleting all peers, messages, conclusions, and other resources associated
with the workspace.

Returns 409 Conflict if the workspace contains active sessions.
Delete all sessions first, then delete the workspace.

This action cannot be undone.

## Path parameters

- `workspace_id` string, required

## Response `202`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 10 revisions in range; 2 could not be searched.

- **2026-02-26** (v3) `0730be052dc9` — 1 breaking, 3 info
  - removed the success response with the status `204`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added the success response with the status `202`

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

---

[API](https://skmtc.dev/plastic-labs/apis/honcho-api.md) · [All operations](https://skmtc.dev/plastic-labs/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastic-labs/honcho-api/revisions/63b701d883c9/schema)