v1

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

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 threads delete --thread-id <thread_id>
delete/v0/threads/{thread_id}

Path parameters

thread_idstring required

ID of thread.

Query parameters

permanentboolean nullable

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