---
title: "List archived agent conversations grouped by agent"
method: GET
path: "/agents/conversations/show/archives"
tags: ["Agents"]
---

# List archived agent conversations grouped by agent

`GET /agents/conversations/show/archives`

Returns archived agent conversations for the current user, grouped by
`agentKey`, with pagination over agent groups. Excludes conversations
whose agent was soft-deleted upstream.

## Query parameters

- `agentPage` integer
- `agentLimit` integer

## Response `200`

Grouped archived conversations

- AgentArchivedGroupsResponse — Response from `GET /agents/conversations/show/archives` — archived agent conversations grouped by `agentKey`, with agent-level pagination over the groups and a fixed slice of conversations under each agent.
  - `groups` AgentArchivedConversationGroup[], required
    - `agentKey` string, required — Agent identifier the conversations belong to.
    - `conversations` AgentConversationListItem[], required
      - `_id` string, objectId
      - `agentKey` string — Agent identifier from the route path
      - `userId` string, objectId
      - `orgId` string, objectId
      - `title` string
      - `initiator` string, objectId
      - `status` 'None' | 'Inprogress' | 'Complete' | 'Failed'
      - `failReason` string
      - `modelInfo` ConversationModelInfo — AI model configuration recorded against a conversation or message.
        - `modelKey` string — Stable identifier of the configured model record
        - `modelName` string — Provider-facing model name (e.g. `gpt-4o-mini`)
        - `modelProvider` string — Provider key (e.g. `openai`, `anthropic`)
        - `modelFriendlyName` string — Human-readable display name
        - `chatMode` string — Chat mode used for this turn (e.g. `quick`, `internal_search`)
      - `isShared` boolean
      - `shareLink` string
      - `sharedWith` object[]
        - `userId` string, objectId
        - `accessLevel` 'read' | 'write'
      - `isArchived` boolean
      - `archivedBy` string, objectId, nullable
      - `archivedAt` string, date-time — Present on archived conversation endpoints. Derived from the document `updatedAt` timestamp when the archive response is built.
      - `isDeleted` boolean
      - `deletedBy` string, objectId, nullable
      - `conversationErrors` object[]
        - `message` string
        - `errorType` string
        - `timestamp` string, date-time
        - `messageId` string, objectId
        - `stack` string
        - `metadata` object
      - `conversationSource` 'agent_chat'
      - `lastActivityAt` integer — Epoch milliseconds of the latest activity on the thread
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `isOwner` boolean — Computed per request. `true` when the conversation `initiator` matches the authenticated user.
      - `accessLevel` 'read' | 'write' — Computed per request from `sharedWith`; defaults to `read` when no explicit share grant is attached to the serialized row.
    - `pagination` SemanticSearchHistoryPagination, required — Pagination block emitted by `buildPaginationMetadata` (utils.ts:417). `totalPages` is `Math.ceil(totalCount / limit)`, so an empty result has `totalPages: 0`, not `1`.
      - `page` integer, required
      - `limit` integer, required
      - `totalCount` integer, required
      - `totalPages` integer, required
      - `hasNextPage` boolean, required
      - `hasPrevPage` boolean, required
  - `agentPagination` SemanticSearchHistoryPagination, required — Pagination block emitted by `buildPaginationMetadata` (utils.ts:417). `totalPages` is `Math.ceil(totalCount / limit)`, so an empty result has `totalPages: 0`, not `1`.
    - `page` integer, required
    - `limit` integer, required
    - `totalCount` integer, required
    - `totalPages` integer, required
    - `hasNextPage` boolean, required
    - `hasPrevPage` boolean, required
  - `meta` RequestMeta, required — Basic request metadata returned by the API.
    - `requestId` string
    - `timestamp` string, date-time, required
    - `duration` integer, required

## Other responses

- `401` — Unauthorized

---

[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/revisions/64bfe76b130e/schema)