Clarify the conversation custom attribute descriptions

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: yasser-aboelgheit-intercom

descriptions/0/api.intercom.io.yaml

@@ -38050,8 +38050,9 @@ components:
       description: >-
         An object containing the custom attributes on a conversation as key-value
         pairs. For relationship attributes the value is a list of custom object
-        instance models. System-defined attributes such as "CX Score rating",
-        "CX Score explanation" and "CX Score reasons" may also be included.
+        instance models. System-defined attributes such as "AI Topic and Subtopic",
+        "CX Score rating", "CX Score explanation" and "CX Score reasons" may also be
+        included.
       properties:
         "AI Topic and Subtopic":
           type: array
@@ -38107,7 +38108,7 @@ components:
       type: object
       description: The custom attributes which are set on this object, as key-value
         pairs. For relationship attributes the value should be a list of custom object
-        instance models. Only attributes a caller may set are accepted here — attributes
+        instance models. Only attributes a caller may set should be sent here — attributes
         Intercom generates are returned in responses only.
       additionalProperties:
         anyOf:

descriptions/2.17/api.intercom.io.yaml

@@ -33638,8 +33638,9 @@ components:
       description: >-
         An object containing the custom attributes on a conversation as key-value
         pairs. For relationship attributes the value is a list of custom object
-        instance models. System-defined attributes such as "CX Score rating",
-        "CX Score explanation" and "CX Score reasons" may also be included.
+        instance models. System-defined attributes such as "AI Topic and Subtopic",
+        "CX Score rating", "CX Score explanation" and "CX Score reasons" may also be
+        included.
       properties:
         "AI Topic and Subtopic":
           type: array
@@ -33695,7 +33696,7 @@ components:
       type: object
       description: The custom attributes which are set on this object, as key-value
         pairs. For relationship attributes the value should be a list of custom object
-        instance models. Only attributes a caller may set are accepted here — attributes
+        instance models. Only attributes a caller may set should be sent here — attributes
         Intercom generates are returned in responses only.
       additionalProperties:
         anyOf: