From 98a259b2c113e9cce2dd12220590e280b197dcee Mon Sep 17 00:00:00 2001 From: Mark Dennis Date: Wed, 14 Oct 2026 15:03:17 +0100 Subject: [PATCH 1/2] Show the occupancy events in the activity log examples In 2.16, 2.17 and Preview, add an admin_occupancy_state_change and an admin_occupancy_setting_change entry to the GET /admins/activity_logs and POST /admins/activity_logs/search response examples, so they show previous_state, new_state, threshold_minutes, last_activity_at, auto, setting_type and changes. The state change is recorded by the system, so its performed_by ip is `unknown`. The before and after values in activity_log_metadata.changes get an example each, and their descriptions say they take the setting's own type. They keep no `type`, because the value can be an integer, a boolean, a string or a list depending on the setting. Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/0/api.intercom.io.yaml | 72 +++++++++++++++++++++++++- descriptions/2.16/api.intercom.io.yaml | 72 +++++++++++++++++++++++++- descriptions/2.17/api.intercom.io.yaml | 72 +++++++++++++++++++++++++- 3 files changed, 210 insertions(+), 6 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index d8bffc96..11cfeefc 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -256,6 +256,37 @@ paths: activity_description: Ciaran5 Lee changed your Initial message title message from Initial message title to Eventual message title. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -374,6 +405,37 @@ paths: activity_type: app_name_change activity_description: Ciaran5 Lee changed your app name from before to after. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -29838,9 +29900,15 @@ components: type: object properties: before: - description: The value before the change. + description: The value before the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 15 after: - description: The value after the change. + description: The value after the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 30 example: occupancy_window_minutes: before: 15 diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 56d6ee48..883bdb70 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -621,6 +621,37 @@ paths: activity_description: Ciaran5 Lee changed your Initial message title message from Initial message title to Eventual message title. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -739,6 +770,37 @@ paths: activity_type: app_name_change activity_description: Ciaran5 Lee changed your app name from before to after. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -23483,9 +23545,15 @@ components: type: object properties: before: - description: The value before the change. + description: The value before the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 15 after: - description: The value after the change. + description: The value after the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 30 example: occupancy_window_minutes: before: 15 diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml index 2d99a8ad..e42a49a1 100644 --- a/descriptions/2.17/api.intercom.io.yaml +++ b/descriptions/2.17/api.intercom.io.yaml @@ -621,6 +621,37 @@ paths: activity_description: Ciaran5 Lee changed your Initial message title message from Initial message title to Eventual message title. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -739,6 +770,37 @@ paths: activity_type: app_name_change activity_description: Ciaran5 Lee changed your app name from before to after. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -26052,9 +26114,15 @@ components: type: object properties: before: - description: The value before the change. + description: The value before the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 15 after: - description: The value after the change. + description: The value after the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 30 example: occupancy_window_minutes: before: 15 From a2621901d3edb64988d6773387ee2e38726380dd Mon Sep 17 00:00:00 2001 From: Mark Dennis Date: Wed, 14 Oct 2026 15:03:37 +0100 Subject: [PATCH 2/2] Show the occupancy events in the 2.14 and 2.15 activity log examples In 2.14 and 2.15, add an admin_occupancy_state_change and an admin_occupancy_setting_change entry to the GET /admins/activity_logs response example, so it shows previous_state, new_state, threshold_minutes, last_activity_at, auto, setting_type and changes. The state change is recorded by the system, so its performed_by ip is `unknown`. The before and after values in activity_log_metadata.changes get an example each, and their descriptions say they take the setting's own type. They keep no `type`, because the value can be an integer, a boolean, a string or a list depending on the setting. Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/2.14/api.intercom.io.yaml | 41 ++++++++++++++++++++++++-- descriptions/2.15/api.intercom.io.yaml | 41 ++++++++++++++++++++++++-- 2 files changed, 78 insertions(+), 4 deletions(-) diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 759b4a70..10b94260 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -256,6 +256,37 @@ paths: activity_description: Ciaran5 Lee changed your Initial message title message from Initial message title to Eventual message title. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -15557,9 +15588,15 @@ components: type: object properties: before: - description: The value before the change. + description: The value before the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 15 after: - description: The value after the change. + description: The value after the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 30 example: occupancy_window_minutes: before: 15 diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index dd07cae5..a18a2039 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -256,6 +256,37 @@ paths: activity_description: Ciaran5 Lee changed your Initial message title message from Initial message title to Eventual message title. + - id: 9eedfb5c-b5c2-4105-bf17-a9acedf29e8d + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: unknown + metadata: + previous_state: idle + new_state: occupied + threshold_minutes: 15 + last_activity_at: 1734537195 + auto: true + created_at: 1734537253 + activity_type: admin_occupancy_state_change + activity_description: Ciaran5 Lee changed from idle to occupied. + - id: 25023ca3-acbd-43ca-a3b5-ff30a516d017 + performed_by: + type: admin + id: '991267464' + email: admin5@email.com + ip: 127.0.0.1 + metadata: + setting_type: teammate_occupancy + changes: + occupancy_window_minutes: + before: 15 + after: 30 + created_at: 1734537253 + activity_type: admin_occupancy_setting_change + activity_description: Ciaran5 Lee updated the occupancy window + to 30 minutes. schema: "$ref": "#/components/schemas/activity_log_list" '401': @@ -16181,9 +16212,15 @@ components: type: object properties: before: - description: The value before the change. + description: The value before the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 15 after: - description: The value after the change. + description: The value after the change. It has the setting's + own type, such as an integer for `occupancy_window_minutes` or + a boolean for `occupancy_window_active`. + example: 30 example: occupancy_window_minutes: before: 15