From e6c3b62de373e1fa5bb30ac9f60f74a919a85fba Mon Sep 17 00:00:00 2001 From: adisa narula Date: Tue, 10 Feb 2026 14:01:36 +0000 Subject: [PATCH 1/2] 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 From 7736711dfcf2d7fc2cfd1066973a449b0f9e9753 Mon Sep 17 00:00:00 2001 From: adisa narula Date: Tue, 3 Mar 2026 15:26:33 +0000 Subject: [PATCH 2/2] Remove company_id from conversation response schema The company_id field is not returned by the API in conversation responses, so it should not be in the conversation schema. Note: company_id in update_conversation_request schema is preserved as it is correctly used in PUT request bodies. --- descriptions/0/api.intercom.io.yaml | 5 ----- descriptions/2.14/api.intercom.io.yaml | 5 ----- descriptions/2.15/api.intercom.io.yaml | 5 ----- 3 files changed, 15 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index b401874..70ff6aa 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -17951,11 +17951,6 @@ components: description: The id of the team assigned to the conversation. If it's not assigned to a team it will return null. example: '5017691' - company_id: - type: string - description: The ID of the company that the conversation is associated with. - The unique identifier for the company which is given by Intercom. - example: 5f4d3c1c-7b1b-4d7d-a97e-6095715c6632 company: "$ref": "#/components/schemas/company" nullable: true diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 9f137e1..42d61cf 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -16725,11 +16725,6 @@ components: description: The id of the team assigned to the conversation. If it's not assigned to a team it will return null. example: '5017691' - company_id: - type: string - description: The ID of the company that the conversation is associated with. - The unique identifier for the company which is given by Intercom. - example: 5f4d3c1c-7b1b-4d7d-a97e-6095715c6632 tags: "$ref": "#/components/schemas/tags" conversation_rating: diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 1a270de..07b96a0 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -17381,11 +17381,6 @@ components: description: The id of the team assigned to the conversation. If it's not assigned to a team it will return null. example: '5017691' - company_id: - type: string - description: The ID of the company that the conversation is associated with. - The unique identifier for the company which is given by Intercom. - example: 5f4d3c1c-7b1b-4d7d-a97e-6095715c6632 company: "$ref": "#/components/schemas/company" nullable: true