Skip to content

Commit e6c3b62

Browse files
adisan19claude
andcommitted
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 <noreply@anthropic.com>
1 parent 8184aad commit e6c3b62

File tree

4 files changed

+24
-4
lines changed

4 files changed

+24
-4
lines changed

descriptions/0/api.intercom.io.yaml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6753,7 +6753,12 @@ paths:
67536753
tags:
67546754
- Conversations
67556755
operationId: deleteConversation
6756-
description: You can delete a single conversation.
6756+
description: |
6757+
{% admonition type="warning" name="Irreversible operation" %}
6758+
Deleting a conversation is permanent and cannot be reversed.
6759+
{% /admonition %}
6760+
6761+
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.
67576762
responses:
67586763
'200':
67596764
description: successful

descriptions/2.13/api.intercom.io.yaml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6244,7 +6244,12 @@ paths:
62446244
tags:
62456245
- Conversations
62466246
operationId: deleteConversation
6247-
description: You can delete a single conversation.
6247+
description: |
6248+
{% admonition type="warning" name="Irreversible operation" %}
6249+
Deleting a conversation is permanent and cannot be reversed.
6250+
{% /admonition %}
6251+
6252+
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.
62486253
responses:
62496254
'200':
62506255
description: successful

descriptions/2.14/api.intercom.io.yaml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6705,7 +6705,12 @@ paths:
67056705
tags:
67066706
- Conversations
67076707
operationId: deleteConversation
6708-
description: You can delete a single conversation.
6708+
description: |
6709+
{% admonition type="warning" name="Irreversible operation" %}
6710+
Deleting a conversation is permanent and cannot be reversed.
6711+
{% /admonition %}
6712+
6713+
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.
67096714
responses:
67106715
'200':
67116716
description: successful

descriptions/2.15/api.intercom.io.yaml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6776,7 +6776,12 @@ paths:
67766776
tags:
67776777
- Conversations
67786778
operationId: deleteConversation
6779-
description: You can delete a single conversation.
6779+
description: |
6780+
{% admonition type="warning" name="Irreversible operation" %}
6781+
Deleting a conversation is permanent and cannot be reversed.
6782+
{% /admonition %}
6783+
6784+
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.
67806785
responses:
67816786
'200':
67826787
description: successful

0 commit comments

Comments
 (0)