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

# Delete Session

`DELETE /v3/workspaces/{workspace_id}/sessions/{session_id}`

Delete a Session and all associated messages.

The Session is marked as inactive immediately and returns 202 Accepted. The actual
deletion of all related data happens asynchronously via the queue with retry support.

This action cannot be undone.

## Path parameters

- `workspace_id` string, required
- `session_id` string, required

## Response `202`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-26** (v3) `0730be052dc9` — 2 info
  - 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

[Change history](https://skmtc.dev/plastic-labs/apis/honcho-api/changes/v3/workspaces/:workspace_id/sessions/:session_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)
