diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 771bbf30..7474c0f5 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -14056,6 +14056,10 @@ paths:
 
         To send these replies as outbound emails, reach out to your accounts team to enable the email-reply feature flag for your workspace.
         {% /admonition %}
+
+        {% admonition type="info" name="Managing a conversation" %}
+        To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/preview/rest-api/api.intercom.io/conversations/manageconversation).
+        {% /admonition %}
       responses:
         '200':
           description: User last conversation reply
@@ -14518,6 +14522,10 @@ paths:
         - Snooze a conversation to reopen on a future date
         - Open a conversation which is `snoozed` or `closed`
         - Assign a conversation to an admin and/or team.
+
+        {% admonition type="info" name="Sending messages" %}
+        To send a comment, note or quick reply, use [Reply to a conversation](/docs/references/preview/rest-api/api.intercom.io/conversations/replyconversation).
+        {% /admonition %}
       responses:
         '200':
           description: Assign a conversation
diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml
index d6a70646..60288a65 100644
--- a/descriptions/2.16/api.intercom.io.yaml
+++ b/descriptions/2.16/api.intercom.io.yaml
@@ -12495,6 +12495,10 @@ paths:
 
         To send these replies as outbound emails, reach out to your accounts team to enable the email-reply feature flag for your workspace.
         {% /admonition %}
+
+        {% admonition type="info" name="Managing a conversation" %}
+        To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/rest-api/api.intercom.io/conversations/manageconversation).
+        {% /admonition %}
       responses:
         '200':
           description: User last conversation reply
@@ -12941,6 +12945,10 @@ paths:
         - Snooze a conversation to reopen on a future date
         - Open a conversation which is `snoozed` or `closed`
         - Assign a conversation to an admin and/or team.
+
+        {% admonition type="info" name="Sending messages" %}
+        To send a comment, note or quick reply, use [Reply to a conversation](/docs/references/rest-api/api.intercom.io/conversations/replyconversation).
+        {% /admonition %}
       responses:
         '200':
           description: Assign a conversation