diff --git a/modules/ROOT/attachments/cloud-api.yaml b/modules/ROOT/attachments/cloud-api.yaml
index a01a588ef..eac1a4998 100644
--- a/modules/ROOT/attachments/cloud-api.yaml
+++ b/modules/ROOT/attachments/cloud-api.yaml
@@ -890,7 +890,7 @@ components:
           title: Secret scopes
           type: array
         secret_data:
-          description: The secret data.
+          description: The secret data. Must be Base64-encoded.
           format: byte
           type: string
       required:
@@ -5507,7 +5507,7 @@ paths:
                   description: Name of connector.
                   type: string
                 secret_data:
-                  description: The secret data.
+                  description: The secret data. Must be Base64-encoded.
                   format: byte
                   type: string
               required:
@@ -5672,7 +5672,7 @@ paths:
                   description: Secret labels.
                   type: object
                 secret_data:
-                  description: The secret data.
+                  description: The secret data. Must be Base64-encoded.
                   format: byte
                   type: string
               required:
@@ -6277,7 +6277,7 @@ paths:
                   title: Secret scopes
                   type: array
                 secret_data:
-                  description: The secret data.
+                  description: The secret data. Must be Base64-encoded.
                   format: byte
                   type: string
               required: