AWS solutions documentation change

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

File: solutions/latest/dea-api/cases-my-cases.md

Summary

Updated 'My cases' endpoint documentation with authentication requirements, pagination, and detailed response schema including permission enums

Security assessment

Adds explicit documentation about authentication/authorization requirements and case access permissions. The CaseAction and status enums help clarify security boundaries but don't address a specific vulnerability. Strengthens documentation of access control features.

Diff

diff --git a/solutions/latest/dea-api/cases-my-cases.md b/solutions/latest/dea-api/cases-my-cases.md
index 228f993b6..7a9136906 100644
--- a//solutions/latest/dea-api/cases-my-cases.md
+++ b//solutions/latest/dea-api/cases-my-cases.md
@@ -5 +5 @@
-URIHTTP methods
+URIHTTP methodsSchemasProperties
@@ -7 +7,3 @@ URIHTTP methods
-#  Cases My-cases
+# Cases – My cases
+
+This endpoint provides a way for users to retrieve a list of cases they are associated with in DEA, facilitating case managment and access. The API requires authentication and authorization to ensure that only authorized users can retrieve the list of cases they are associated with. 
@@ -20,0 +23 @@ Query parametersName| Type| Required| Description
+`limit`| Integer| False|   
@@ -22,3 +24,0 @@ Query parametersName| Type| Required| Description
-`limit`| String| False|   
-  
-### OPTIONS
@@ -28 +28,86 @@ ResponsesStatus code| Response model| Description
-`204`| None| 204 response  
+`200`| `My_cases_response`| Success  
+  
+## Schemas
+
+### Response bodies
+    
+    
+    {
+      "total": number,
+      "cases": {
+      },
+      "next": "string"
+    }
+
+## Properties
+
+### CaseAction
+
+  * `VIEW_CASE_DETAILS`
+
+  * `UPDATE_CASE_DETAILS`
+
+  * `UPDATE_CASE_STATUS`
+
+  * `UPLOAD`
+
+  * `DOWNLOAD`
+
+  * `VIEW_FILES`
+
+  * `CASE_AUDIT`
+
+  * `INVITE`
+
+  * `RESTORE_FILES`
+
+
+
+
+### CaseFileStatus
+
+  * `ACTIVE`
+
+  * `DELETING`
+
+  * `DELETE_FAILED`
+
+  * `DELETED`
+
+  * `PENDING`
+
+
+
+
+### CaseStatus
+
+  * `ACTIVE`
+
+  * `INACTIVE`
+
+
+
+
+### MyCase
+
+Property| Type| Required| Description  
+---|---|---|---  
+`actions`| Array of type CaseAction| False|   
+`created`| string| False|   
+`description`| string| False|   
+`fileStatus`| CaseFileStatus| False|   
+`name`| string| False|   
+`objectCount`| number| False|   
+`s3BatchJobId`| string| False|   
+`status`| CaseStatus| False|   
+`totalSizeBytes`| number| False|   
+`ulid`| string| False|   
+`updated`| string| False|   
+  
+### My_cases_response
+
+Property| Type| Required| Description  
+---|---|---|---  
+`cases`| object| False|   
+`next`| string| False|   
+`total`| number| False|   
@@ -36 +121 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please
-Cases caseId Users userId Memberships
+Cases – Manage user memberships
@@ -38 +123 @@ Cases caseId Users userId Memberships
-Datasync Tasks
+Cases – Restore files