پرش به مستندات
سرور MCP

چت‌های دستیار

گفت‌وگوهایی که با دستیار در اپ انجام شده.

ابزارهای چت‌های دستیار

ابزارچه می‌کند
listChatsچت‌هایی که با دستیار در اپ انجام شده، تازه‌ترین‌ها اول، با عنوان‌شان و شمار پیام‌های هرکدام. query عنوان‌ها را جست‌وجو می‌کند. هر بار یک صفحه برگردانده می‌شود.
getChatیک چت با شناسه‌اش.
renameChatبه یک چت عنوانی تازه بدهید.
deleteChatیک چت و همهٔ پیام‌هایش را برای همیشه حذف کنید. هیچ کاری که دستیار در صندوق انجام داده برگردانده نمی‌شود.

فقط مالک فضای کاری به چت‌ها دسترسی دارد، از راه کلاینتی که با همهٔ نشانی‌ها وصل شده. خواندن به threads:read و تغییر به threads:write نیاز دارد.

دستیار درون اپ این ابزارها را ندارد، پس هیچ چتی خودش را تغییر نام نمی‌دهد یا حذف نمی‌کند.

مرجع

listChats

محدوده‌های دسترسیthreads:readفقط در MCP، نه در دستیار برنامهجعبه‌ابزارcore

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.

ورودی‌ها

querystring
تا 200 نویسه
sortstring
یکی از"newest""oldest""title"
limitinteger
دست‌کم 1حداکثر 100
cursorstring
1 تا 2048 نویسه

همچنین در دسترس در

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

getChat

محدوده‌های دسترسیthreads:readفقط در MCP، نه در دستیار برنامهجعبه‌ابزارcore

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

ورودی‌ها

idstringالزامی
خالی نباشد

همچنین در دسترس در

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

renameChat

محدوده‌های دسترسیthreads:writeفقط در MCP، نه در دستیار برنامهجعبه‌ابزارcore

Give a chat with the assistant a new title.

ورودی‌ها

idstringالزامی
خالی نباشد
titlestringالزامی
1 تا 120 نویسه

همچنین در دسترس در

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

deleteChat

محدوده‌های دسترسیthreads:writeفقط در MCP، نه در دستیار برنامهجعبه‌ابزارcore

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.

ورودی‌ها

idstringالزامی
خالی نباشد

همچنین در دسترس در

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