v1

latestOpenAPI 3.0.1raw.githubusercontent.com2026-04-2099201202.6 KB
InboxesThreads

Delete Thread

Moves the thread to trash by adding a trash label to all messages. If the thread is already in trash, it will be permanently deleted. Use permanent=true to force permanent deletion.

CLI:

agentmail inboxes:threads delete --inbox-id <inbox_id> --thread-id <thread_id>
delete/v0/inboxes/{inbox_id}/threads/{thread_id}

Path parameters

inbox_idstring required

The ID of the inbox.

thread_idstring required

ID of thread.

Query parameters

permanentboolean nullable

If true, permanently delete the thread instead of moving to trash.