AWS solutions documentation change

Service: solutions · 2025-04-20 · Documentation medium

File: solutions/latest/dea-api/cases-caseid-files-fileid-audit.md

Summary

Expanded audit trail documentation with request/response schemas and explicit security/compliance context

Security assessment

Added explicit mention of audit trails being crucial for security and compliance. While this improves security transparency, it documents existing functionality rather than addressing a specific vulnerability.

Diff

diff --git a/solutions/latest/dea-api/cases-caseid-files-fileid-audit.md b/solutions/latest/dea-api/cases-caseid-files-fileid-audit.md
index 0eee54628..c10c0827a 100644
--- a//solutions/latest/dea-api/cases-caseid-files-fileid-audit.md
+++ b//solutions/latest/dea-api/cases-caseid-files-fileid-audit.md
@@ -5 +5 @@
-URIHTTP methods
+URIHTTP methodsSchemasProperties
@@ -7 +7,3 @@ URIHTTP methods
-#  Cases caseId Files fileId Audit
+# Cases – File audit by caseId and fileId
+
+This endpoint provides a way to retrieve the audit trail or history of actions performed on a specific file or piece of evidence identified by fileId within a case identified by caseId. The audit trail is crucial for security and compliance purposes, as it provides a record of who accessed the file and what actions were taken. 
@@ -17,7 +18,0 @@ URIHTTP methods
-Path parametersName| Type| Required| Description  
----|---|---|---  
-`caseId`| String| True| Case ID to generate audit log for  
-`fileId`| String| True| File ID to generate audit log for  
-  
-### OPTIONS
-
@@ -27 +22 @@ Path parametersName| Type| Required| Description
-`fileId`| String| True| File ID to generate audit log for  
+`fileId`| String| True|   
@@ -31 +26,33 @@ ResponsesStatus code| Response model| Description
-`204`| None| 204 response  
+`200`| `Cases_response_200_6`| Audit Query ID  
+  
+## Schemas
+
+### Request bodies
+    
+    
+    {
+      "from": number,
+      "to": number
+    }
+
+### Response bodies
+    
+    
+    {
+      "auditId": "string"
+    }
+
+## Properties
+
+### AuditPayload
+
+Property| Type| Required| Description  
+---|---|---|---  
+`from`| number| False|   
+`to`| number| False|   
+  
+### Cases_response_200_6
+
+Property| Type| Required| Description  
+---|---|---|---  
+`auditId`| string| False|   
@@ -39 +66 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please
-Cases caseId Files
+Cases – CSV audit entry for a case file
@@ -41 +68 @@ Cases caseId Files
-Cases caseId Files fileId Audit auditId Csv
+Cases – File contents