---
title: "Archive conversation"
method: PATCH
path: "/conversations/{conversationId}/archive"
tags: ["Conversations"]
---

# Archive conversation

`PATCH /conversations/{conversationId}/archive`

Archive a conversation to hide it from the main list.

**Overview:**

Archived conversations are preserved but hidden from the default conversation list.
Use archiving to clean up your workspace without permanently deleting conversations.

**Access:**

The caller must be the conversation's initiator, or be listed in `sharedWith`
with `accessLevel: write`. Already-archived conversations return `400`.

**Retrieval:**

View archived conversations using `GET /conversations/show/archives`.
Restore one with `PATCH /conversations/{conversationId}/unarchive`.

## Path parameters

- `conversationId` string, objectId, required

## Response `200`

Conversation archived successfully

- object
  - `id` string, objectId — Conversation identifier
  - `status` 'archived' — New archive status of the conversation
  - `archivedBy` string, objectId — User who archived the conversation
  - `archivedAt` string, date-time — Timestamp when the conversation was archived
  - `meta` object
    - `requestId` string — Request correlation identifier
    - `timestamp` string, date-time — Response generation timestamp
    - `duration` integer — Server processing time in milliseconds

## Other responses

- `400` — Conversation is already archived
- `401` — Unauthorized
- `404` — Conversation not found or caller lacks archive permission

---

[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)