---
title: "Delete conversation"
method: DELETE
path: "/conversations/{conversationId}"
tags: ["Conversations"]
---

# Delete conversation

`DELETE /conversations/{conversationId}`

Delete a conversation by its ID.

**Overview:**

Performs a soft delete by setting `isDeleted: true`. The conversation is
removed from listings but preserved in the database. All citations
referenced by messages in the conversation are also soft-deleted.

**Permissions:**

The conversation initiator can always delete. Users the conversation has
been shared with may delete it only when their `sharedWith.accessLevel`
is `write`.

## Path parameters

- `conversationId` string, objectId, required

## Response `200`

Conversation deleted successfully

- object
  - `id` string, objectId — Identifier of the conversation that was deleted
  - `status` 'deleted' — Outcome of the operation
  - `deletedAt` string, date-time — Timestamp when the conversation was marked deleted
  - `deletedBy` string, objectId — Identifier of the user who performed the delete
  - `citationsDeleted` integer — Number of citations soft-deleted alongside the conversation
  - `meta` object
    - `requestId` string — Server-assigned identifier for the request
    - `timestamp` string, date-time — Server time the response was produced
    - `duration` integer — Server processing time in milliseconds

## Other responses

- `400` — Invalid `conversationId` path parameter
- `401` — Unauthorized
- `403` — Forbidden - token is missing the `conversation:write` scope
- `404` — Conversation not found, already deleted, or caller has no delete access
- `500` — Internal server error while deleting the conversation

---

[API](https://skmtc.net/pipeshub-ai/apis/pipeshub-api.md) · [All operations](https://skmtc.net/pipeshub-ai/apis/pipeshub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipeshub-ai/pipeshub-api/versions/abd27cfefc73/schema)