v1

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

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

Path parameters

pod_idstring required

ID of pod.

thread_idstring required

ID of thread.

Query parameters

permanentboolean nullable

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