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 1c7a5951..b401874a 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 50f7bbea..309db147 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 2d34dd73..9f137e1a 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 792942c4..1a270de4 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