diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 2cb2b4da..e7fca13e 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -22298,6 +22298,12 @@ paths:
                     errors:
                     - code: parameter_invalid
                       message: rating must be an integer from 1 to 5
+                Remark too long:
+                  value:
+                    type: error.list
+                    errors:
+                    - code: parameter_invalid
+                      message: remark must be at most 65535 bytes
               schema:
                 "$ref": "#/components/schemas/error"
         '401':
@@ -47626,7 +47632,8 @@ components:
           example: 4
         remark:
           type: string
-          description: Free text from the contact to go with the rating.
+          description: |-
+            Free text from the contact to go with the rating. It can be at most 65535 bytes. The limit counts bytes, not characters, so text with multi-byte characters has a lower character limit.
           example: Fast and friendly
     rated_conversation:
       title: Rated conversation
diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml
index 4de276a0..0147f165 100644
--- a/descriptions/2.16/api.intercom.io.yaml
+++ b/descriptions/2.16/api.intercom.io.yaml
@@ -13830,6 +13830,12 @@ paths:
                     errors:
                     - code: parameter_invalid
                       message: rating must be an integer from 1 to 5
+                Remark too long:
+                  value:
+                    type: error.list
+                    errors:
+                    - code: parameter_invalid
+                      message: remark must be at most 65535 bytes
               schema:
                 "$ref": "#/components/schemas/error"
         '401':
@@ -28641,7 +28647,8 @@ components:
           example: 4
         remark:
           type: string
-          description: Free text from the contact to go with the rating.
+          description: |-
+            Free text from the contact to go with the rating. It can be at most 65535 bytes. The limit counts bytes, not characters, so text with multi-byte characters has a lower character limit.
           example: Fast and friendly
     rated_conversation:
       title: Rated conversation
diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml
index 77362586..df822843 100644
--- a/descriptions/2.17/api.intercom.io.yaml
+++ b/descriptions/2.17/api.intercom.io.yaml
@@ -21517,6 +21517,12 @@ paths:
                     errors:
                     - code: parameter_invalid
                       message: rating must be an integer from 1 to 5
+                Remark too long:
+                  value:
+                    type: error.list
+                    errors:
+                    - code: parameter_invalid
+                      message: remark must be at most 65535 bytes
               schema:
                 "$ref": "#/components/schemas/error"
         '401':
@@ -40871,7 +40877,8 @@ components:
           example: 4
         remark:
           type: string
-          description: Free text from the contact to go with the rating.
+          description: |-
+            Free text from the contact to go with the rating. It can be at most 65535 bytes. The limit counts bytes, not characters, so text with multi-byte characters has a lower character limit.
           example: Fast and friendly
     rated_conversation:
       title: Rated conversation