diff --git a/src/Appwrite/Utopia/Response/Model/Variable.php b/src/Appwrite/Utopia/Response/Model/Variable.php
index d479eb541c..22f76e44d4 100644
--- a/src/Appwrite/Utopia/Response/Model/Variable.php
+++ b/src/Appwrite/Utopia/Response/Model/Variable.php
@@ -44,7 +44,7 @@ class Variable extends Model
             ])
             ->addRule('secret', [
                 'type' => self::TYPE_BOOLEAN,
-                'description' => 'Variable secret flag.',
+                'description' => 'Variable secret flag. Secret variables can only be updated or deleted, but never read.',
                 'default' => false,
                 'example' => false,
             ])