Skip to main content
Every chat you have with the Assistant is kept for you in the chat sidebar, so you can pick up a conversation where you left off. This page shows you how to browse that history, reopen a past chat, find the one you want, and clean up the chats you no longer need.
A quick note on the words used here. A “chat” and a “conversation” mean the same thing: one thread of messages with the Assistant. Your chat history is the running list of those threads, newest activity first.

Where your history lives

Your chats live in the Assistant panel — the secondary sidebar that opens beside the chat view. The panel lists your conversations as a single, scrollable list, with the most recently active chat at the top.

New chat

The + button at the top of the panel starts a fresh conversation. A new chat appears in the list as soon as you send its first message.

Your chats only

The list shows the chats you created in the current organization. Switch organizations and the list reloads to show that organization’s chats.

Newest first

Chats are ordered by their most recent activity, so a conversation you just replied to jumps back to the top.

Auto-named

Each chat is named automatically from your first message, so you can recognize it later without naming it yourself.
Don’t see the panel? Open a chat from the main navigation, then look for the Assistant panel on the left. You can pin it open so it stays visible as you work.

Browse and reopen a chat

The history list is built for skimming. Each row tells you what the chat is about and when you last touched it.
1

Scan the list

Each row shows the chat’s title and a relative date — Today, Yesterday, 3 days ago, or a short date like Mar 4 for older chats. A green dot on a row means that chat is still running a response right now.
2

Open a chat

Select a row to open that conversation in the main view. The full message history loads, including any tool steps the Assistant took and any question it is still waiting on you to answer.
3

Load older chats

The list loads your most recent chats first. If you have more, a Show more button appears at the bottom — select it to pull in the next batch of older conversations.
A pulsing green dot marks a chat where the Assistant is actively working on a reply. You can open it to watch the response stream in live, or keep working elsewhere and come back — the chat keeps running in the background. See Chat overview for how a live response streams in.
The list is sorted by most recent activity, not by when the chat was created. Sending a new message in an old conversation brings it back to the top, so your active threads stay close at hand.
If the Assistant paused to ask you something — for approval before it runs a tool, or for a missing detail — that question reappears when you reopen the chat, so you can answer and let it continue. Learn more in Run a workflow from chat and Chat with your knowledge.

Find a past chat

Today, you find an older chat by browsing: open the Assistant panel, scan from the top (newest activity first), and select Show more to reach older conversations. Because each chat is auto-named from its first message, the titles make the right one easy to spot.
ModuleX does not yet have a built-in search box for filtering your chat history by keyword. To locate an older chat, browse the list and use Show more to load more of it. This is tracked in Known limitations.

Tips for finding a chat faster

  • Start your conversations with a clear, specific first line — that line becomes the chat’s title and the easiest thing to recognize later.
  • Recently active chats sit at the top, so a conversation you touched today is rarely far down.
  • If a chat belongs to a different organization, switch to that organization first — the list only shows the current organization’s chats.

A note on folders

ModuleX does not organize chats into folders. Your conversations live in one flat, time-ordered list rather than in named folders or groups.
Folders were part of an earlier chat experience that has since been replaced by today’s Assistant chat, which uses the single time-ordered history described above. There is no way to create a folder or move a chat into one in the current app. If folder-style organization matters to your team, let us know through Getting help — and check Known limitations for the current state.

Delete chats you no longer need

You can remove a single chat or clear out several at once. Deleting a chat removes it and its messages from your history.

Delete one chat

1

Open the row menu

Hover over a chat row and select the more actions () button that appears on the right.
2

Choose Delete

Select Delete. A confirmation dialog asks you to confirm — deleting removes the conversation and its messages from your chats.
3

Confirm

Confirm in the dialog. If you delete the chat you currently have open, the app returns you to a fresh new-chat view.

Delete several chats at once

1

Enter select mode

Select Select at the top of the panel. Each row gains a checkbox.
2

Pick the chats

Tick every chat you want to remove. A counter shows how many you’ve selected.
3

Delete the selection

Select Delete, then confirm. The chats are removed together, and the panel leaves select mode.
Deleting a chat cannot be undone from the app. Make sure you have what you need from a conversation before you remove it.

Who can use chat

The Assistant chat — and therefore your chat history — is available to organization owners and admins. If you can’t see the chat surface, ask an owner or admin in your organization about your role.
ModuleX uses two organization roles: owner and admin. The older member role has been retired and is not a current role. See Roles & permissions for what each role can do.

Browse your chats from the API

The same history you see in the sidebar is available programmatically. The list is user-scoped to the calling key’s user and the organization in the request, returns your chats newest activity first, and is cursor-paginated — each page hands back a cursor you pass in to fetch the next, older page. Authenticate every request with your API key and the organization header, exactly as on every other ModuleX endpoint (see Authentication):
  • Authorization: Bearer mx_live_…
  • X-Organization-ID: <your organization id>
Two query parameters control paging: A response returns the page of chats in items and a next_cursor. When next_cursor is null, you’ve reached the end of the list.
Each item in items carries the same fields the sidebar shows:
Like every managed-usage surface, the Assistant chat endpoints sit behind the usage gate: a request can be refused with a 402, 403, or 429 and a billing denial body when your plan’s limits are reached. Listing chat history is a read and does not consume credits, but starting or resuming a chat does. See Errors & status codes for the response shapes.

Keep going

Chat overview

What you can do in a chat: ask the Assistant, run a workflow, and query your knowledge.

Private & org chat

How chats are scoped to you and your organization, and who can see them.

Run a workflow from chat

Trigger and watch a workflow run without leaving the conversation.

The ModuleX app

A tour of chat, the builder, knowledge, and integrations.