diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
index e2256f32bd5a..4916263c378c 100644
--- a/.generator/schemas/v2/openapi.yaml
+++ b/.generator/schemas/v2/openapi.yaml
@@ -75872,7 +75872,9 @@ paths:
       - Case Management
   /api/v2/cases/{case_id}/attributes:
     post:
-      description: Update case attributes
+      description: Update case attributes. This replaces all attributes with the provided
+        payload. To update a single attribute (e.g., team), include all existing attributes
+        in the request to avoid overwriting them.
       operationId: UpdateAttributes
       parameters:
       - $ref: '#/components/parameters/CaseIDPathParameter'
diff --git a/services/case_management/src/v2/CaseManagementApi.ts b/services/case_management/src/v2/CaseManagementApi.ts
index 9a57c3cf3351..6d9fb77104a6 100644
--- a/services/case_management/src/v2/CaseManagementApi.ts
+++ b/services/case_management/src/v2/CaseManagementApi.ts
@@ -4925,7 +4925,7 @@ export class CaseManagementApi {
   }
 
   /**
-   * Update case attributes
+   * Update case attributes. This replaces all attributes with the provided payload. To update a single attribute (e.g., team), include all existing attributes in the request to avoid overwriting them.
    * @param param The request object
    */
   public updateAttributes(