From 9634d0ec946eed7a0f488fb745af78c8a7591728 Mon Sep 17 00:00:00 2001
From: Ebenezer Don <ebenezerdonu@gmail.com>
Date: Wed, 15 Jan 2025 22:16:07 +0000
Subject: [PATCH] docs: clarify update endpoints only work on draft messages

---
 .gitignore                                | 3 ++-
 docs/references/messaging/update-email.md | 2 +-
 docs/references/messaging/update-push.md  | 2 +-
 docs/references/messaging/update-sms.md   | 2 +-
 4 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index 0c19fd215e..1d03c6a7e4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,4 +16,5 @@ dev/yasd_init.php
 .phpunit.result.cache
 Makefile
 appwrite.json
-/.zed/
\ No newline at end of file
+/.zed/
+.history
\ No newline at end of file
diff --git a/docs/references/messaging/update-email.md b/docs/references/messaging/update-email.md
index 89f01d7a11..1f0d4b61a4 100644
--- a/docs/references/messaging/update-email.md
+++ b/docs/references/messaging/update-email.md
@@ -1 +1 @@
-Update an email message by its unique ID.
+Update an email message by its unique ID. This endpoint only works on messages that are in draft status. Messages that are already processing, sent, or failed cannot be updated.
diff --git a/docs/references/messaging/update-push.md b/docs/references/messaging/update-push.md
index dd200a9729..17702f9756 100644
--- a/docs/references/messaging/update-push.md
+++ b/docs/references/messaging/update-push.md
@@ -1 +1 @@
-Update a push notification by its unique ID.
+Update a push notification message by its unique ID. This endpoint only works on messages that are in draft status. Messages that are already processing, sent, or failed cannot be updated.
diff --git a/docs/references/messaging/update-sms.md b/docs/references/messaging/update-sms.md
index 2f9b57a7a7..5a1cb3d67f 100644
--- a/docs/references/messaging/update-sms.md
+++ b/docs/references/messaging/update-sms.md
@@ -1 +1 @@
-Update an SMS message by its unique ID.
+Update an SMS message by its unique ID. This endpoint only works on messages that are in draft status. Messages that are already processing, sent, or failed cannot be updated.