Assistant chats
The conversations held with the assistant in the app.
Assistant chats tools
| Tool | What it does |
|---|---|
| listChats | The chats held with the assistant in the app, newest first, with their titles and how many messages each holds. query searches the titles. Returned a page at a time. |
| getChat | One chat by its id. |
| renameChat | Give a chat a new title. |
| deleteChat | Delete a chat and every message in it, for good. Nothing the assistant did in the mailbox is undone. |
Only the workspace owner reaches the chats, through a client connected with every address. Reading needs threads:read and changing needs threads:write.
The assistant in the app does not have these tools, so a chat never renames or deletes itself.
Reference
listChats
The conversations held with the assistant in the OpenEmail app, as its Chats page lists them, newest first, each with its title, id and how many messages it holds. query searches the titles. Only the workspace owner reaches them. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.
Inputs
querystring- Up to 200 characters
sortstring- One of
"newest""oldest""title" limitinteger- At least 1At most 100
cursorstring- 1 to 2048 characters
Also available in
getChat
One chat with the assistant by its id: its title, how many messages it holds and when it last changed.
Inputs
idstringRequired- Not empty
Also available in
renameChat
Give a chat with the assistant a new title.
Inputs
idstringRequired- Not empty
titlestringRequired- 1 to 120 characters
Also available in
deleteChat
Delete a chat with the assistant and every message in it, for good. Nothing it did in the mailbox is undone. Ask the person first.
Inputs
idstringRequired- Not empty