From e6c3b62de373e1fa5bb30ac9f60f74a919a85fba Mon Sep 17 00:00:00 2001 From: adisa narula Date: Tue, 10 Feb 2026 14:01:36 +0000 Subject: [PATCH] Update DELETE /conversations/{id} endpoint description Enhance the description to clarify that: - Deletion is permanent and cannot be reversed - All sensitive data is removed (replies, attributes, uploads) - Conversation still appears in reporting with incomplete data This provides better clarity for API consumers about the implications of deleting conversations. Co-Authored-By: Claude Sonnet 4.5 --- descriptions/0/api.intercom.io.yaml | 7 ++++++- descriptions/2.13/api.intercom.io.yaml | 7 ++++++- descriptions/2.14/api.intercom.io.yaml | 7 ++++++- descriptions/2.15/api.intercom.io.yaml | 7 ++++++- 4 files changed, 24 insertions(+), 4 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 1c7a595..b401874 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -6753,7 +6753,12 @@ paths: tags: - Conversations operationId: deleteConversation - description: You can delete a single conversation. + description: | + {% admonition type="warning" name="Irreversible operation" %} + Deleting a conversation is permanent and cannot be reversed. + {% /admonition %} + + Deleting a conversation permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, conversation attributes, uploads, and related content. The conversation will still appear in reporting, though some data may be incomplete due to the deletion. responses: '200': description: successful diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 50f7bbe..309db14 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -6244,7 +6244,12 @@ paths: tags: - Conversations operationId: deleteConversation - description: You can delete a single conversation. + description: | + {% admonition type="warning" name="Irreversible operation" %} + Deleting a conversation is permanent and cannot be reversed. + {% /admonition %} + + Deleting a conversation permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, conversation attributes, uploads, and related content. The conversation will still appear in reporting, though some data may be incomplete due to the deletion. responses: '200': description: successful diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 2d34dd7..9f137e1 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -6705,7 +6705,12 @@ paths: tags: - Conversations operationId: deleteConversation - description: You can delete a single conversation. + description: | + {% admonition type="warning" name="Irreversible operation" %} + Deleting a conversation is permanent and cannot be reversed. + {% /admonition %} + + Deleting a conversation permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, conversation attributes, uploads, and related content. The conversation will still appear in reporting, though some data may be incomplete due to the deletion. responses: '200': description: successful diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 792942c..1a270de 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -6776,7 +6776,12 @@ paths: tags: - Conversations operationId: deleteConversation - description: You can delete a single conversation. + description: | + {% admonition type="warning" name="Irreversible operation" %} + Deleting a conversation is permanent and cannot be reversed. + {% /admonition %} + + Deleting a conversation permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, conversation attributes, uploads, and related content. The conversation will still appear in reporting, though some data may be incomplete due to the deletion. responses: '200': description: successful