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

# Manage AI Conversations: History, Search & Sharing

> View, search, and manage your AI assistant conversation history in Layest. Replay past sessions, export transcripts, and share them with teammates.

Every chat session you have with an agent in Layest is saved automatically, giving you a full audit trail of your AI interactions. From the Conversations view you can browse your history, pick up where you left off, share a useful exchange with a colleague, or download a transcript for your records — all without any manual bookkeeping.

## Viewing Conversation History

To open your conversation history, click **Assistant** in the left navigation bar, then select the **Conversations** tab at the top of the panel. All past sessions are listed in reverse chronological order, grouped by date: **Today**, **Yesterday**, **This Week**, and older.

Each entry in the list shows:

* The agent that was used
* The opening message of the session (as a preview)
* The date and time the conversation started
* A token count badge indicating how large the session was

Click any conversation to open a read-only replay view. From there you can continue the session, export it, or share it.

## Searching Past Conversations

Use the **Search** bar at the top of the Conversations panel to find past sessions by keyword. Layest searches across all message content — both your messages and agent responses — and highlights matching terms in the results.

You can narrow results with filters:

<Tabs>
  <Tab title="By Agent">
    Click **Filter → Agent** and select one or more agents from the dropdown. Only conversations involving those agents are shown.
  </Tab>

  <Tab title="By Date Range">
    Click **Filter → Date** and choose a preset range (last 7 days, last 30 days, custom) to limit results to a specific period.
  </Tab>

  <Tab title="By Tag">
    If you have tagged conversations, click **Filter → Tag** to surface sessions with a specific label. Tags are added manually from the conversation detail view.
  </Tab>
</Tabs>

## Replaying or Continuing a Conversation

Opening a past conversation puts you in **Replay** mode, where the full message thread is displayed exactly as it occurred. To pick the conversation back up:

<Steps>
  <Step title="Open the conversation">
    Click the session in the Conversations list to enter Replay mode.
  </Step>

  <Step title="Click Continue">
    Press the **Continue Conversation** button in the top-right of the replay view. Layest re-activates the same agent and loads the prior context window.
  </Step>

  <Step title="Send your next message">
    Type in the input field at the bottom and press **Enter**. The conversation resumes from where it ended.
  </Step>
</Steps>

<Info>
  Context window limits apply when continuing a conversation. If a session is very long, the agent may not have access to the earliest messages. Scroll to the top of the thread to check whether a context-truncation notice appears.
</Info>

## Exporting Conversation Transcripts

You can download any conversation as a structured file for documentation, compliance, or sharing outside Layest.

1. Open the conversation you want to export.
2. Click the **⋯ More** menu in the top-right corner.
3. Select **Export**.
4. Choose a format:
   * **Markdown** — human-readable, preserves formatting and code blocks
   * **JSON** — structured data including metadata, token counts, and timestamps
   * **PDF** — print-ready layout suitable for reports or handoffs

The file downloads immediately to your browser's default download folder.

## Sharing Conversations with Team Members

Share a conversation with anyone in your workspace by generating a shareable link:

1. Open the conversation.
2. Click **Share** in the top-right corner.
3. Choose a permission level:
   * **View only** — recipients can read the thread but not continue it
   * **Continue** — recipients can add messages to a copy of the conversation in their own account
4. Copy the link and send it via your preferred channel.

<Warning>
  Shareable links are accessible to anyone in your workspace who receives them. Avoid sharing conversations that contain sensitive credentials, personal data, or confidential business information unless your workspace's data handling policies explicitly permit it.
</Warning>

## Deleting or Archiving Conversations

To keep your history tidy, you can archive or permanently delete sessions you no longer need.

**Archive** — Moves the conversation out of the main list into the **Archived** folder. Archived sessions are still searchable and can be unarchived at any time. To archive, open the **⋯ More** menu and select **Archive**.

**Delete** — Permanently removes the conversation and all associated messages. This action cannot be undone. To delete, open the **⋯ More** menu, select **Delete**, and confirm the prompt.

To manage multiple conversations at once, tick the checkboxes on the left of each row in the Conversations list, then use the **Bulk actions** toolbar that appears at the bottom.

## Conversation Metadata

Every conversation stores a set of metadata that you can use to understand usage patterns and costs. Click the **Info** icon (ⓘ) in the top-right corner of any conversation to open the metadata panel:

| Field                 | Description                                   |
| --------------------- | --------------------------------------------- |
| **Agent**             | The agent configuration used in this session  |
| **Model**             | The AI model that powered the responses       |
| **Started**           | Date and time the first message was sent      |
| **Duration**          | Wall-clock time from first to last message    |
| **Messages**          | Total number of turns (user + agent)          |
| **Tokens consumed**   | Combined prompt and completion token count    |
| **Knowledge sources** | Any documents or integrations the agent cited |

Workspace admins can view aggregated token usage across all team members in **Settings → Usage**.

<Note>
  Conversation history is retained for **90 days** on the Starter plan and **unlimited** on Pro and Enterprise plans. Deleted conversations are permanently purged after 30 days and cannot be recovered. If your organisation has data residency or retention requirements, contact your account manager to configure a custom policy.
</Note>
