Zur Dokumentation springen
MCP-Server

Assistenten-Chats

Die Unterhaltungen mit dem Assistenten in der App.

Tools für Assistenten-Chats

ToolWas es tut
listChatsDie Chats mit dem Assistenten in der App, die neuesten zuerst, mit ihren Titeln und wie viele Nachrichten jeder enthält. query durchsucht die Titel. Seitenweise zurückgegeben.
getChatEin Chat über seine ID.
renameChatEinem Chat einen neuen Titel geben.
deleteChatEinen Chat und jede Nachricht darin endgültig löschen. Nichts, was der Assistent im Postfach getan hat, wird rückgängig gemacht.

Nur der Workspace-Inhaber erreicht die Chats, über einen Client, der mit jeder Adresse verbunden ist. Lesen erfordert threads:read und Ändern threads:write.

Der Assistent in der App hat diese Tools nicht, also benennt oder löscht sich ein Chat nie selbst.

Referenz

listChats

Geltungsbereichethreads:readNur über MCP, nicht im Assistenten der AppToolkitcore

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.

Eingaben

querystring
Bis zu 200 Zeichen
sortstring
Einer von"newest""oldest""title"
limitinteger
Mindestens 1Höchstens 100
cursorstring
1 bis 2048 Zeichen

Auch verfügbar über

API
GET /chats
SDK
chats.list()chats.listAll()chats.iterate()

getChat

Geltungsbereichethreads:readNur über MCP, nicht im Assistenten der AppToolkitcore

One chat with the assistant by its id: its title, how many messages it holds and when it last changed.

Eingaben

idstringErforderlich
Nicht leer

Auch verfügbar über

API
GET /chats/{id}
SDK
chats.get()

renameChat

Geltungsbereichethreads:writeNur über MCP, nicht im Assistenten der AppToolkitcore

Give a chat with the assistant a new title.

Eingaben

idstringErforderlich
Nicht leer
titlestringErforderlich
1 bis 120 Zeichen

Auch verfügbar über

API
PATCH /chats/{id}
SDK
chats.rename()

deleteChat

Geltungsbereichethreads:writeNur über MCP, nicht im Assistenten der AppToolkitcore

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.

Eingaben

idstringErforderlich
Nicht leer

Auch verfügbar über

API
DELETE /chats/{id}
SDK
chats.delete()