---
title: "Archive an agent conversation"
method: POST
path: "/agents/{agentKey}/conversations/{conversationId}/archive"
tags: ["Agents"]
---

# Archive an agent conversation

`POST /agents/{agentKey}/conversations/{conversationId}/archive`

Marks the conversation as archived for the authenticated owner.

## Path parameters

- `agentKey` string, required
- `conversationId` string, objectId, required

## Response `200`

Conversation archived

- AgentConversationArchiveResponse — Envelope returned by `POST /agents/{agentKey}/conversations/{conversationId}/archive`.
  - `id` string, objectId, required
  - `status` 'archived', required
  - `archivedBy` string, objectId, required
  - `archivedAt` string, date-time, required
  - `meta` AgentConversationArchiveMeta, required — Request-scoped metadata returned by the archive route. `requestId` is omitted when upstream middleware did not attach one.
    - `requestId` string
    - `timestamp` string, date-time, required
    - `duration` integer, required

## Other responses

- `400` — Invalid path input or the conversation is already archived.
- `401` — Unauthorized
- `404` — Conversation not found

---

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