Update DELETE /conversations/{id} endpoint description (#361)

Author: adisan19

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

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

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

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