From 7a5b374ed9781054a1a2a607022af015345b3964 Mon Sep 17 00:00:00 2001 From: Mark Dennis Date: Wed, 18 Nov 2026 14:38:36 +0000 Subject: [PATCH] Say deleted conversations are kept for 7 days in 2.13 to Preview Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 4 ++-- descriptions/2.13/api.intercom.io.yaml | 6 +++--- descriptions/2.14/api.intercom.io.yaml | 6 +++--- descriptions/2.15/api.intercom.io.yaml | 6 +++--- descriptions/2.16/api.intercom.io.yaml | 4 ++-- descriptions/2.17/api.intercom.io.yaml | 4 ++-- descriptions/2.18/api.intercom.io.yaml | 4 ++-- 7 files changed, 17 insertions(+), 17 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index be1e95bf..cef85dc4 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -19982,8 +19982,8 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Irreversible after the recovery window" %} + With `retain_metrics=false`, deleting a conversation is permanent and cannot be reversed. With the default `retain_metrics=true`, the conversation's data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /admonition %} You can delete a single conversation. The behavior depends on the `retain_metrics` parameter: diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 2e3ceea1..494f4b59 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -6367,11 +6367,11 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Limited recovery window" %} + Deleting a conversation removes it from the inbox immediately. Its data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /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. + Deleting a conversation removes it from the inbox. Its data, including admin and user replies, conversation attributes, uploads, and related content, is permanently deleted 7 days later. 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 65f61023..39a2c541 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -7980,11 +7980,11 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Limited recovery window" %} + Deleting a conversation removes it from the inbox immediately. Its data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /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. + Deleting a conversation removes it from the inbox. Its data, including admin and user replies, conversation attributes, uploads, and related content, is permanently deleted 7 days later. 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 497e6fb9..87f71c19 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -7234,11 +7234,11 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Limited recovery window" %} + Deleting a conversation removes it from the inbox immediately. Its data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /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. + Deleting a conversation removes it from the inbox. Its data, including admin and user replies, conversation attributes, uploads, and related content, is permanently deleted 7 days later. 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.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index e5477253..c0bc28d3 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -12213,8 +12213,8 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Irreversible after the recovery window" %} + With `retain_metrics=false`, deleting a conversation is permanent and cannot be reversed. With the default `retain_metrics=true`, the conversation's data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /admonition %} You can delete a single conversation. The behavior depends on the `retain_metrics` parameter: diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml index c2f0399f..2db52d28 100644 --- a/descriptions/2.17/api.intercom.io.yaml +++ b/descriptions/2.17/api.intercom.io.yaml @@ -19543,8 +19543,8 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Irreversible after the recovery window" %} + With `retain_metrics=false`, deleting a conversation is permanent and cannot be reversed. With the default `retain_metrics=true`, the conversation's data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /admonition %} You can delete a single conversation. The behavior depends on the `retain_metrics` parameter: diff --git a/descriptions/2.18/api.intercom.io.yaml b/descriptions/2.18/api.intercom.io.yaml index e62216e4..3ac72148 100644 --- a/descriptions/2.18/api.intercom.io.yaml +++ b/descriptions/2.18/api.intercom.io.yaml @@ -20064,8 +20064,8 @@ paths: - Conversations operationId: deleteConversation description: | - {% admonition type="warning" name="Irreversible operation" %} - Deleting a conversation is permanent and cannot be reversed. + {% admonition type="warning" name="Irreversible after the recovery window" %} + With `retain_metrics=false`, deleting a conversation is permanent and cannot be reversed. With the default `retain_metrics=true`, the conversation's data is retained for 7 days before being permanently deleted, and recovering it during that window isn't available through the API. {% /admonition %} You can delete a single conversation. The behavior depends on the `retain_metrics` parameter: