---
title: "Read Archived Chat"
method: GET
path: "/workspaces/{workspace_id}/chat-archive/{chat_id}"
tags: ["chat-archive"]
---

# Read Archived Chat

`GET /workspaces/{workspace_id}/chat-archive/{chat_id}`

## Path parameters

- `chat_id` string, uuid, required
- `workspace_id` string, uuid, required

## Query parameters

- `message_limit` integer, nullable

## Response `200`

Successful Response

- ReadArchivedChatResponse
  - `chat` ArchivedChat, required — The one chat shape, used internally and on the wire. The first eight fields are `chat_archive_chats` table columns; the rest are computed when the row is fetched (see `shape_chats`).
    - `id` string, uuid, required
    - `owner_id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `population_id` string, uuid, required
    - `persona_id` string, uuid, nullable, required
    - `chat_name` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `population_name` string, nullable, required
    - `persona_name` string, nullable, required
    - `can_write` boolean, required
  - `messages` ArchivedChatMessage[], required
    - `id` string, uuid, required
    - `role` 'user' | 'assistant', required
    - `metadata` ArchivedChatMessageMetadata, required
      - `chatId` string, required
      - `custom` ArchivedChatMessageCustom
        - `demographicFilter` object, required
    - `parts` union[]
      - union
        - TextPart
          - `type` 'text'
          - `text` string, required
        - FilePart
          - `type` 'file'
          - `url` string, required
          - `mediaType` string, required
          - `filename` string, nullable
        - ProgressToolPart
          - `type` 'dynamic-tool'
          - `toolName` string, required
          - `toolCallId` string, required
          - `title` string, required
          - `providerExecuted` true
          - `state` 'output-available'
          - `input` object
          - `output` ProgressToolOutput, required
            - `status` 'done' | 'skipped' | 'error', required
            - `summary` object, nullable
        - ResponseClustersPart
          - `type` 'data-responseClusters'
          - `data` PopulationClusters, required
            - `question` string
            - `headline` string
            - `total` integer
            - `codes` ResponseClusterCode[]
              - …

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/useauxos/apis/auxos.md) · [All operations](https://skmtc.dev/useauxos/apis/auxos/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/useauxos/auxos/revisions/2f853c0b59f4/schema)