Allow require reason on storage changes

Author: XingY

CHANGELOG.md

@@ -1,8 +1,12 @@
 # The LabKey Remote API Library for Java - Change Log
 
-## version 7.3.0-SNAPSHOT
+## version 7.4.0-SNAPSHOT
 *Released*: TBD
+
+## version 7.3.0
+*Released*: X June 2026
 * Update Gradle version and remove some deprecated syntax
+* Add support for `auditUserComment` on `BaseStorageCommand` (`CreateCommand`, `UpdateCommand`, `DeleteCommand`)
 
 ## version 7.2.0
 *Released*: 17 February 2026

build.gradle

@@ -70,7 +70,7 @@ repositories {
 
 group = "org.labkey.api"
 
-version = "7.3.0-SNAPSHOT"
+version = "7.3.0-storageComment-SNAPSHOT"
 
 dependencies {
     api "org.json:json:${jsonObjectVersion}"

src/org/labkey/remoteapi/storage/BaseStorageCommand.java

@@ -21,6 +21,7 @@
 public abstract class BaseStorageCommand extends PostCommand<StorageCommandResponse>
 {
     private final StorageRow _storageRow;
+    private String _auditUserComment;
 
     public BaseStorageCommand(String action, StorageRow storageRow)
     {
@@ -47,6 +48,22 @@ protected StorageCommandResponse createResponse(String text, int status, String
     @Override
     public JSONObject getJsonObject()
     {
-        return _storageRow.toJsonObject();
+        JSONObject json = _storageRow.toJsonObject();
+        if (_auditUserComment != null)
+            json.put("auditUserComment", _auditUserComment);
+        return json;
+    }
+
+    public String getAuditUserComment()
+    {
+        return _auditUserComment;
+    }
+
+    /**
+     * @param auditUserComment the comment to attach to the audit log record for this storage change.
+     */
+    public void setAuditUserComment(String auditUserComment)
+    {
+        _auditUserComment = auditUserComment;
     }
 }