From 0207169388caed9ef43fab487e4bd5832702f478 Mon Sep 17 00:00:00 2001 From: Laszlo Bogacsi Date: Wed, 5 Aug 2026 11:17:02 +0100 Subject: [PATCH 1/3] Document the admin_occupancy_state_change activity log event Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 30 ++++++++++++++++++++++++++ descriptions/2.14/api.intercom.io.yaml | 29 +++++++++++++++++++++++++ descriptions/2.15/api.intercom.io.yaml | 29 +++++++++++++++++++++++++ descriptions/2.16/api.intercom.io.yaml | 30 ++++++++++++++++++++++++++ 4 files changed, 118 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 2ecca2e..886c538 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -427,6 +427,7 @@ paths: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -26257,6 +26258,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -26412,6 +26414,34 @@ components: nullable: true description: The name of the Admin who initiated the activity. example: Joe Example + previous_state: + type: string + nullable: true + description: The state before the change. `idle` or `occupied`, and null + when the Admin had not been classified yet. + example: idle + new_state: + type: string + nullable: true + description: The state after the change. `idle` or `occupied`. + example: occupied + threshold_minutes: + type: integer + nullable: true + description: The inactivity window, in minutes, used to classify the Admin. + example: 15 + last_activity_at: + type: integer + format: date-time + nullable: true + description: The time of the Admin's last recorded activity. + example: 1671028894 + auto: + type: boolean + nullable: true + description: Indicates the state was derived automatically rather than set + by an Admin. + example: true conversation_assignment_limit: type: integer nullable: true diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 01382eb..0d04226 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -14619,6 +14619,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -14782,6 +14783,34 @@ components: nullable: true description: The name of the Admin who initiated the activity. example: Joe Example + previous_state: + type: string + nullable: true + description: The state before the change. `idle` or `occupied`, and null + when the Admin had not been classified yet. + example: idle + new_state: + type: string + nullable: true + description: The state after the change. `idle` or `occupied`. + example: occupied + threshold_minutes: + type: integer + nullable: true + description: The inactivity window, in minutes, used to classify the Admin. + example: 15 + last_activity_at: + type: integer + format: date-time + nullable: true + description: The time of the Admin's last recorded activity. + example: 1671028894 + auto: + type: boolean + nullable: true + description: Indicates the state was derived automatically rather than set + by an Admin. + example: true conversation_assignment_limit: type: integer nullable: true diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 97dd42e..7c8f31b 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -15233,6 +15233,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -15405,6 +15406,34 @@ components: nullable: true description: The name of the Admin who initiated the activity. example: Joe Example + previous_state: + type: string + nullable: true + description: The state before the change. `idle` or `occupied`, and null + when the Admin had not been classified yet. + example: idle + new_state: + type: string + nullable: true + description: The state after the change. `idle` or `occupied`. + example: occupied + threshold_minutes: + type: integer + nullable: true + description: The inactivity window, in minutes, used to classify the Admin. + example: 15 + last_activity_at: + type: integer + format: date-time + nullable: true + description: The time of the Admin's last recorded activity. + example: 1671028894 + auto: + type: boolean + nullable: true + description: Indicates the state was derived automatically rather than set + by an Admin. + example: true conversation_assignment_limit: type: integer nullable: true diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index e95e43e..dcfeaea 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -792,6 +792,7 @@ paths: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -22442,6 +22443,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -22635,6 +22637,34 @@ components: nullable: true description: The name of the Admin who initiated the activity. example: Joe Example + previous_state: + type: string + nullable: true + description: The state before the change. `idle` or `occupied`, and null + when the Admin had not been classified yet. + example: idle + new_state: + type: string + nullable: true + description: The state after the change. `idle` or `occupied`. + example: occupied + threshold_minutes: + type: integer + nullable: true + description: The inactivity window, in minutes, used to classify the Admin. + example: 15 + last_activity_at: + type: integer + format: date-time + nullable: true + description: The time of the Admin's last recorded activity. + example: 1671028894 + auto: + type: boolean + nullable: true + description: Indicates the state was derived automatically rather than set + by an Admin. + example: true conversation_assignment_limit: type: integer nullable: true From b7276fba840b123f2b2eea54efaaa6166093e6fa Mon Sep 17 00:00:00 2001 From: Laszlo Bogacsi Date: Wed, 5 Aug 2026 14:22:48 +0100 Subject: [PATCH 2/3] Also document the event in 2.13 Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/2.13/api.intercom.io.yaml | 29 ++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index dd53b58..fede3b3 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -13099,6 +13099,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success - admin_permission_change @@ -13231,6 +13232,34 @@ components: nullable: true description: The name of the Admin who initiated the activity. example: Joe Example + previous_state: + type: string + nullable: true + description: The state before the change. `idle` or `occupied`, and null + when the Admin had not been classified yet. + example: idle + new_state: + type: string + nullable: true + description: The state after the change. `idle` or `occupied`. + example: occupied + threshold_minutes: + type: integer + nullable: true + description: The inactivity window, in minutes, used to classify the Admin. + example: 15 + last_activity_at: + type: integer + format: date-time + nullable: true + description: The time of the Admin's last recorded activity. + example: 1671028894 + auto: + type: boolean + nullable: true + description: Indicates the state was derived automatically rather than set + by an Admin. + example: true addressable_list: title: Addressable List type: object From ac05789bf751655645c80531273642a903c3e648 Mon Sep 17 00:00:00 2001 From: Laszlo Bogacsi Date: Wed, 5 Aug 2026 17:31:24 +0100 Subject: [PATCH 3/3] Document the admin_occupancy_setting_change activity log event --- descriptions/0/api.intercom.io.yaml | 25 +++++++++++++++++++++++++ descriptions/2.13/api.intercom.io.yaml | 24 ++++++++++++++++++++++++ descriptions/2.14/api.intercom.io.yaml | 24 ++++++++++++++++++++++++ descriptions/2.15/api.intercom.io.yaml | 24 ++++++++++++++++++++++++ descriptions/2.16/api.intercom.io.yaml | 25 +++++++++++++++++++++++++ 5 files changed, 122 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 886c538..80c026b 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -427,6 +427,7 @@ paths: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -26258,6 +26259,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -26442,6 +26444,29 @@ components: description: Indicates the state was derived automatically rather than set by an Admin. example: true + setting_type: + type: string + nullable: true + description: The group of workspace settings the change belongs to, for + example `teammate_occupancy` or `automatic_away_mode`. + example: teammate_occupancy + changes: + type: object + nullable: true + description: The settings altered by the change, keyed by setting name. + Only settings whose value actually moved are included, so an unchanged + setting is absent rather than present with equal values. + additionalProperties: + type: object + properties: + before: + description: The value before the change. + after: + description: The value after the change. + example: + occupancy_window_minutes: + before: 15 + after: 30 conversation_assignment_limit: type: integer nullable: true diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index fede3b3..d225578 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -13099,6 +13099,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -13260,6 +13261,29 @@ components: description: Indicates the state was derived automatically rather than set by an Admin. example: true + setting_type: + type: string + nullable: true + description: The group of workspace settings the change belongs to, for + example `teammate_occupancy` or `automatic_away_mode`. + example: teammate_occupancy + changes: + type: object + nullable: true + description: The settings altered by the change, keyed by setting name. + Only settings whose value actually moved are included, so an unchanged + setting is absent rather than present with equal values. + additionalProperties: + type: object + properties: + before: + description: The value before the change. + after: + description: The value after the change. + example: + occupancy_window_minutes: + before: 15 + after: 30 addressable_list: title: Addressable List type: object diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 0d04226..2b224f0 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -14619,6 +14619,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -14811,6 +14812,29 @@ components: description: Indicates the state was derived automatically rather than set by an Admin. example: true + setting_type: + type: string + nullable: true + description: The group of workspace settings the change belongs to, for + example `teammate_occupancy` or `automatic_away_mode`. + example: teammate_occupancy + changes: + type: object + nullable: true + description: The settings altered by the change, keyed by setting name. + Only settings whose value actually moved are included, so an unchanged + setting is absent rather than present with equal values. + additionalProperties: + type: object + properties: + before: + description: The value before the change. + after: + description: The value after the change. + example: + occupancy_window_minutes: + before: 15 + after: 30 conversation_assignment_limit: type: integer nullable: true diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 7c8f31b..49ae729 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -15233,6 +15233,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -15434,6 +15435,29 @@ components: description: Indicates the state was derived automatically rather than set by an Admin. example: true + setting_type: + type: string + nullable: true + description: The group of workspace settings the change belongs to, for + example `teammate_occupancy` or `automatic_away_mode`. + example: teammate_occupancy + changes: + type: object + nullable: true + description: The settings altered by the change, keyed by setting name. + Only settings whose value actually moved are included, so an unchanged + setting is absent rather than present with equal values. + additionalProperties: + type: object + properties: + before: + description: The value before the change. + after: + description: The value after the change. + example: + occupancy_window_minutes: + before: 15 + after: 30 conversation_assignment_limit: type: integer nullable: true diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index dcfeaea..5b27176 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -792,6 +792,7 @@ paths: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -22443,6 +22444,7 @@ components: - admin_login_failure - admin_login_success - admin_logout + - admin_occupancy_setting_change - admin_occupancy_state_change - admin_password_reset_request - admin_password_reset_success @@ -22665,6 +22667,29 @@ components: description: Indicates the state was derived automatically rather than set by an Admin. example: true + setting_type: + type: string + nullable: true + description: The group of workspace settings the change belongs to, for + example `teammate_occupancy` or `automatic_away_mode`. + example: teammate_occupancy + changes: + type: object + nullable: true + description: The settings altered by the change, keyed by setting name. + Only settings whose value actually moved are included, so an unchanged + setting is absent rather than present with equal values. + additionalProperties: + type: object + properties: + before: + description: The value before the change. + after: + description: The value after the change. + example: + occupancy_window_minutes: + before: 15 + after: 30 conversation_assignment_limit: type: integer nullable: true