From c8ede4885bb832545c078bf800dfb8ccfd909308 Mon Sep 17 00:00:00 2001 From: Nanette Taylor Date: Tue, 29 Sep 2026 15:50:34 +0100 Subject: [PATCH 1/2] Link Reply to a conversation and Manage a conversation The Reply page only lists comment, note and quick_reply for admins, so readers don't find close, open, snooze or assign. Point each endpoint at the other in Preview and 2.16. Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 9 ++++++++- descriptions/2.16/api.intercom.io.yaml | 9 ++++++++- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 771bbf30..649fdaaf 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -14518,6 +14518,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 @@ -28563,7 +28567,10 @@ components: admin_reply_conversation_request: title: Admin Reply type: object - description: Payload of the request to reply on behalf of an admin + description: |- + Payload of the request to reply on behalf of an admin. + + To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/preview/rest-api/api.intercom.io/conversations/manageconversation). properties: message_type: type: string diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index d6a70646..4601fca3 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -12941,6 +12941,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 @@ -23588,7 +23592,10 @@ components: admin_reply_conversation_request: title: Admin Reply type: object - description: Payload of the request to reply on behalf of an admin + description: |- + Payload of the request to reply on behalf of an admin. + + To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/rest-api/api.intercom.io/conversations/manageconversation). properties: message_type: type: string From bf39883f8ae03943328cfa8f57216fbad2fe782a Mon Sep 17 00:00:00 2001 From: Nanette Taylor Date: Tue, 29 Sep 2026 17:11:24 +0100 Subject: [PATCH 2/2] Move Reply cross-link into an info box below the bot replies warning Places the Reply to a conversation link in the same spot as the one on Manage a conversation, so both endpoints show it the same way. Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 9 +++++---- descriptions/2.16/api.intercom.io.yaml | 9 +++++---- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 649fdaaf..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 @@ -28567,10 +28571,7 @@ components: admin_reply_conversation_request: title: Admin Reply type: object - description: |- - Payload of the request to reply on behalf of an admin. - - To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/preview/rest-api/api.intercom.io/conversations/manageconversation). + description: Payload of the request to reply on behalf of an admin properties: message_type: type: string diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 4601fca3..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 @@ -23592,10 +23596,7 @@ components: admin_reply_conversation_request: title: Admin Reply type: object - description: |- - Payload of the request to reply on behalf of an admin. - - To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/rest-api/api.intercom.io/conversations/manageconversation). + description: Payload of the request to reply on behalf of an admin properties: message_type: type: string