---
title: "Archive Session"
method: DELETE
path: "/sessions/{session_id}"
---

# Archive Session

`DELETE /sessions/{session_id}`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/sessions/{session_id}`
- Auth: none declared

Soft-delete a session by archiving it.

Sets ``archived_at`` on the session so it no longer surfaces in any read
path; all child data is preserved. The session must be owned by the
caller and in the IDLE state.

Response:
{
    "success": True,
    "message": "Session deleted successfully."
}

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- DeleteSessionResponse: Response for delete_session endpoint.
  - `success` boolean, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)