From 8d6bf07db7522bc358b6e4e0437eff92fca8bbf9 Mon Sep 17 00:00:00 2001 From: yasser-aboelgheit-intercom Date: Wed, 21 Oct 2026 15:09:20 +0100 Subject: [PATCH 1/3] Say which parts carry translations and that body can briefly lag Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/0/api.intercom.io.yaml | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index dcbc3ebd..f639856a 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -36426,7 +36426,10 @@ components: `original` key holds the source locale code of the reply when it is known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify - `body`. Available from API version 2.16. + `body`. Available from API version 2.16. Only present on parts + authored by an admin or bot, never on parts from a contact. The + translations are rendered on every request while `body` can come from + a cached copy, so the two can briefly differ. This webhook topic is not sent for every translated reply: it is suppressed when the reply's `body` contains any text outside an HTML block element, which includes plain-text replies created through the REST API. @@ -45525,7 +45528,10 @@ components: `original` key holds the source locale code of the reply when it is known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify - `body`. Available from API version 2.16. + `body`. Available from API version 2.16. Only present on parts + authored by an admin or bot, never on parts from a contact. The + translations are rendered on every request while `body` can come from + a cached copy, so the two can briefly differ. This webhook topic is not sent for every translated reply: it is suppressed when the reply's `body` contains any text outside an HTML block element, which includes plain-text replies created through the REST API. @@ -45721,7 +45727,10 @@ components: `original` key holds the source locale code of the reply when it is known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify - `body`. Available from API version 2.16. + `body`. Available from API version 2.16. Only present on parts + authored by an admin or bot, never on parts from a contact. The + translations are rendered on every request while `body` can come from + a cached copy, so the two can briefly differ. This webhook topic is not sent for every translated reply: it is suppressed when the reply's `body` contains any text outside an HTML block element, which includes plain-text replies created through the REST API. From bc94056e5eff33ba8de6349920668e55200697a3 Mon Sep 17 00:00:00 2001 From: yasser-aboelgheit-intercom Date: Wed, 21 Oct 2026 18:33:00 +0100 Subject: [PATCH 2/3] Say translations can be null or omitted Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/0/api.intercom.io.yaml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index f639856a..e83a58c0 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -36426,8 +36426,8 @@ components: `original` key holds the source locale code of the reply when it is known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify - `body`. Available from API version 2.16. Only present on parts - authored by an admin or bot, never on parts from a contact. The + `body`. Available from API version 2.16. Can be `null` or omitted, + and always is on parts from a contact. The translations are rendered on every request while `body` can come from a cached copy, so the two can briefly differ. This webhook topic is not sent for every translated reply: it is @@ -45528,8 +45528,8 @@ components: `original` key holds the source locale code of the reply when it is known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify - `body`. Available from API version 2.16. Only present on parts - authored by an admin or bot, never on parts from a contact. The + `body`. Available from API version 2.16. Can be `null` or omitted, + and always is on parts from a contact. The translations are rendered on every request while `body` can come from a cached copy, so the two can briefly differ. This webhook topic is not sent for every translated reply: it is @@ -45727,8 +45727,8 @@ components: `original` key holds the source locale code of the reply when it is known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify - `body`. Available from API version 2.16. Only present on parts - authored by an admin or bot, never on parts from a contact. The + `body`. Available from API version 2.16. Can be `null` or omitted, + and always is on parts from a contact. The translations are rendered on every request while `body` can come from a cached copy, so the two can briefly differ. This webhook topic is not sent for every translated reply: it is From 03bd277764ad35e155fc16f794302bb198b8c18c Mon Sep 17 00:00:00 2001 From: yasser-aboelgheit-intercom Date: Tue, 27 Oct 2026 15:05:54 +0000 Subject: [PATCH 3/3] Say body and translations can differ for plain-text parts There is no cache behind body on the REST endpoints. For parts created with a plain-text body, body returns that text while translations are built from the part's content blocks, so the two can differ. Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/0/api.intercom.io.yaml | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index e83a58c0..f97e0750 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -36427,9 +36427,10 @@ components: known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify `body`. Available from API version 2.16. Can be `null` or omitted, - and always is on parts from a contact. The - translations are rendered on every request while `body` can come from - a cached copy, so the two can briefly differ. + and always is on parts from a contact. For parts + created with a plain-text `body`, `body` returns that text while the + translations are built from the part's content blocks, so the two can + differ. This webhook topic is not sent for every translated reply: it is suppressed when the reply's `body` contains any text outside an HTML block element, which includes plain-text replies created through the REST API. @@ -45529,9 +45530,10 @@ components: known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify `body`. Available from API version 2.16. Can be `null` or omitted, - and always is on parts from a contact. The - translations are rendered on every request while `body` can come from - a cached copy, so the two can briefly differ. + and always is on parts from a contact. For parts + created with a plain-text `body`, `body` returns that text while the + translations are built from the part's content blocks, so the two can + differ. This webhook topic is not sent for every translated reply: it is suppressed when the reply's `body` contains any text outside an HTML block element, which includes plain-text replies created through the REST API. @@ -45728,9 +45730,10 @@ components: known; every other key is a locale code whose value is the reply text translated into that locale. The `translations` field does not modify `body`. Available from API version 2.16. Can be `null` or omitted, - and always is on parts from a contact. The - translations are rendered on every request while `body` can come from - a cached copy, so the two can briefly differ. + and always is on parts from a contact. For parts + created with a plain-text `body`, `body` returns that text while the + translations are built from the part's content blocks, so the two can + differ. This webhook topic is not sent for every translated reply: it is suppressed when the reply's `body` contains any text outside an HTML block element, which includes plain-text replies created through the REST API.