diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessmentMetadata.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessmentMetadata.json
index 61a8fedc77ae..1c8f34c48ddf 100644
--- a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessmentMetadata.json
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessmentMetadata.json
@@ -527,9 +527,9 @@
           "description": "Name of the product of the partner that created the assessment"
         },
         "secret": {
-          "x-ms-secret": true,
+          "description": "Secret to authenticate the partner and verify it created the assessment - write only",
           "type": "string",
-          "description": "Secret to authenticate the partner and verify it created the assessment - write only"
+          "x-ms-secret": true
         }
       },
       "required": [
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessments.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessments.json
index 1c0972c5d631..f9e7261296cd 100644
--- a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessments.json
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/assessments.json
@@ -283,9 +283,9 @@
           "description": "Name of the company of the partner"
         },
         "secret": {
-          "x-ms-secret": true,
+          "description": "secret to authenticate the partner - write only",
           "type": "string",
-          "description": "secret to authenticate the partner - write only"
+          "x-ms-secret": true
         }
       },
       "required": [