> ## Documentation Index
> Fetch the complete documentation index at: https://honeydew.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat history

Honeydew stores a record of every [Deep Analysis](https://honeydew.ai/docs/integration/context-layer/deep-analysis.md)
chat in a workspace and branch, with the agent, domain and model it used, and the
[feedback](https://honeydew.ai/docs/integration/context-layer/deep-analysis.md#feedback) users left. Chat history is
available in the Honeydew UI and via the
[GraphQL API](https://honeydew.ai/docs/integration/graphql-api.md#list-deep-analysis-chats).

A chat can hold several questions. For a record of each question, see
[Question history](https://honeydew.ai/docs/monitoring/question-history.md).

## Access

**Admin** users can see all chats across the organization. Other users can only see their own
chats.

## Chat history includes

| Field | Description |
| - | - |
| Chat | The chat title |
| Agent | The [agent](https://honeydew.ai/docs/integration/context-layer/agents.md) the chat used |
| Domain | The [domain](https://honeydew.ai/docs/domains.md) the chat used |
| Model | The LLM model the chat used |
| Client | The application the chat was started from, such as the Honeydew web app or an MCP client. `Unknown` when the application did not identify itself |
| Created | When the chat started. Chats are listed newest first |
| Status | The state of the chat's latest question. See [Status](#status) |
| User | The user who started the chat. Shown to Admin users only |
| Feedback | The feedback the user left on the chat |
| Chat ID | The chat's unique ID |

## Status

| Status | Meaning |
| - | - |
| Running | The analysis is answering a question now |
| Finished | The latest question was answered |
| Waiting for reply | The analysis asked the user a clarifying question |
| Failed | The latest question ended with an error |
| Stopped | The user stopped the analysis |

Chats whose latest question ended before the status was recorded show no status until their
next question.

## Filters

Chats can be filtered by any combination of:

* **User**: Admin users only, since other users see only their own chats
* **Agent** and **Domain**
* **Client**
* **Status**
* **Created**: a date range

## GraphQL API

Chat history is available through these GraphQL queries, with the same access rules:

| Query | Description |
| - | - |
| [`get_all_chats(limit, offset, params)`](https://honeydew.ai/docs/integration/graphql-api#list-deep-analysis-chats) | The chats, newest first, with optional filters in `params` |
| [`get_all_chats_distinct_options`](https://honeydew.ai/docs/integration/graphql-api#list-deep-analysis-chat-filter-options) | The values each filter can take |
| [`get_chat(chat_id)`](https://honeydew.ai/docs/integration/graphql-api#get-deep-analysis-chat) | One chat, including its full message history |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.