From be06ff6c45f762266428559caab5b88970ea009d Mon Sep 17 00:00:00 2001 From: anubhav-intercom Date: Tue, 14 Apr 2026 11:52:34 +0100 Subject: [PATCH 1/2] Clarify applied_at/applied_by are context-dependent on Tag schema These fields are only present when a tag is returned as part of a tagging operation (attach/detach/list on a contact/conversation/ticket). They are not included in direct tag lookups (GET /tags, GET /tags/{id}). Customers were confused because the Tag docs page showed these fields, but GET /tags/{id} uses the tag_basic schema which excludes them. Fixes https://github.com/intercom/intercom/issues/283507 Co-Authored-By: Claude Opus 4.6 (1M context) --- descriptions/0/api.intercom.io.yaml | 4 ++-- descriptions/2.10/api.intercom.io.yaml | 4 ++-- descriptions/2.11/api.intercom.io.yaml | 4 ++-- descriptions/2.12/api.intercom.io.yaml | 4 ++-- descriptions/2.13/api.intercom.io.yaml | 4 ++-- descriptions/2.14/api.intercom.io.yaml | 4 ++-- descriptions/2.15/api.intercom.io.yaml | 4 ++-- descriptions/2.7/api.intercom.io.yaml | 4 ++-- descriptions/2.8/api.intercom.io.yaml | 4 ++-- descriptions/2.9/api.intercom.io.yaml | 4 ++-- 10 files changed, 20 insertions(+), 20 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 7ef512d..74cc22c 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -26652,12 +26652,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index ca304f8..8c681da 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -15982,12 +15982,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 05ac17f..eeff1bb 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -17649,12 +17649,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" required: diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 50e2c69..7fcdf55 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -17373,12 +17373,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 9efab15..0d62744 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -18984,12 +18984,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index af5c5a8..4fe0fe1 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -20913,12 +20913,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 2bd584e..e67e76b 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -21772,12 +21772,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index ecac991..5fc8f3b 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -13981,12 +13981,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index b6a0e44..a7dff68 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -14004,12 +14004,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index c2c78eb..cf1f0c1 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -15358,12 +15358,12 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). example: 1663597223 applied_by: type: object nullable: true - description: The admin who applied the tag + description: The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. allOf: - "$ref": "#/components/schemas/reference" tag_basic: From 222f096e5d6e452abddcfd7a5ffe43f3b6edb94c Mon Sep 17 00:00:00 2001 From: anubhav-intercom Date: Tue, 14 Apr 2026 13:11:04 +0100 Subject: [PATCH 2/2] Nit: use consistent short description for applied_at and applied_by Both fields now use the same clarification suffix for consistency. Co-Authored-By: Claude Opus 4.6 (1M context) --- descriptions/0/api.intercom.io.yaml | 2 +- descriptions/2.10/api.intercom.io.yaml | 2 +- descriptions/2.11/api.intercom.io.yaml | 2 +- descriptions/2.12/api.intercom.io.yaml | 2 +- descriptions/2.13/api.intercom.io.yaml | 2 +- descriptions/2.14/api.intercom.io.yaml | 2 +- descriptions/2.15/api.intercom.io.yaml | 2 +- descriptions/2.7/api.intercom.io.yaml | 2 +- descriptions/2.8/api.intercom.io.yaml | 2 +- descriptions/2.9/api.intercom.io.yaml | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 74cc22c..2ba7fb7 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -26652,7 +26652,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 8c681da..b180793 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -15982,7 +15982,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index eeff1bb..ea31455 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -17649,7 +17649,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 7fcdf55..fa34686 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -17373,7 +17373,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 0d62744..230d8f4 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -18984,7 +18984,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 4fe0fe1..829c0f2 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -20913,7 +20913,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index e67e76b..8581d7a 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -21772,7 +21772,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index 5fc8f3b..eb6b412 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -13981,7 +13981,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index a7dff68..cd29bdc 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -14004,7 +14004,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index cf1f0c1..9662535 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -15358,7 +15358,7 @@ components: type: integer format: date-time nullable: true - description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id}). + description: The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. example: 1663597223 applied_by: type: object