From 9362a7664e824f364339f76475764df21595d332 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Tue, 28 Apr 2026 05:40:08 +0100
Subject: [PATCH] docs(readme): clarify gmail trash workflow

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index bb9a1c5..0c4a770 100644
--- a/README.md
+++ b/README.md
@@ -689,13 +689,16 @@ gog gmail autoreply 'from:alerts@example.com newer_than:7d' --body-file ./reply.
 gog gmail labels list
 gog gmail labels get INBOX --json  # Includes message counts
 gog gmail labels create "My Label"
+gog gmail labels create "Projects/Review"  # Nested Gmail label
 gog gmail labels rename "Old Label" "New Label"
 gog gmail labels style "My Label" --text-color "#ffffff" --background-color "#4285f4"
 gog gmail labels modify <threadId> --add STARRED --remove INBOX
 gog gmail labels delete <labelIdOrName>  # Deletes user label (guards system labels; confirm)
 
 # Batch operations
-gog gmail batch delete <messageId> <messageId>
+gog gmail trash <messageId> <messageId>          # Move to trash; works with gmail.modify
+gog gmail trash --query 'older_than:30d' --max 100
+gog gmail batch delete <messageId> <messageId>   # Permanent delete; requires https://mail.google.com/
 gog gmail batch modify <messageId> <messageId> --add STARRED --remove INBOX
 
 # Filters