---
title: "Purge Chat Session"
method: DELETE
path: "/api/v1/chat/sessions/{session_id}/purge"
tags: ["Chat"]
---

# Purge Chat Session

`DELETE /api/v1/chat/sessions/{session_id}/purge`

## Request

- Base URL: `https://api.gemina.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemina.co/api/v1/chat/sessions/{session_id}/purge`
- Auth: API key in header `X-API-Key`

Permanently destroy a conversation's stored content. IRREVERSIBLE.

Messages are deleted, trace content is scrubbed, and the title is cleared;
a stub row survives as the record of the purge. Transient conversational
state on the chat backend expires within approximately 24 hours.

Deliberately NOT available to retrieval tokens: they carry a single
query-only scope minted for embedded widgets, and granting them
irreversible deletion would be a least-privilege regression.

## Path parameters

- `session_id` string, uuid, required

## Response `204`

Successful Response

## Other responses

- `404`: The resource does not exist, or is not visible to the caller. Ownership failures are deliberately indistinguishable from a missing resource.
- `422`: Request validation failed (`HTTPValidationError`), or the request was understood but cannot be applied — e.g. the extraction is under legal hold or did not complete successfully (`FoundationDTO`).

---

[API](https://skmtc.dev/gemina/apis/gemina-api.md) · [All operations](https://skmtc.dev/gemina/apis/gemina-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemina/apis/gemina-api/revisions/152fd3f6f6ec?raw)