Document the Admin occupancy activity log events (#614)

* Document the admin_occupancy_state_change activity log event

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Also document the event in 2.13

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Document the admin_occupancy_setting_change activity log event

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: laszlobogacsi-intercom

descriptions/0/api.intercom.io.yaml

@@ -427,6 +427,8 @@ 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
                     - admin_permission_change
@@ -26382,6 +26384,8 @@ 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
           - admin_permission_change
@@ -26537,6 +26541,57 @@ 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
+        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

descriptions/2.13/api.intercom.io.yaml

@@ -13099,6 +13099,8 @@ 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
           - admin_permission_change
@@ -13231,6 +13233,57 @@ 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
+        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

descriptions/2.14/api.intercom.io.yaml

@@ -14619,6 +14619,8 @@ 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
           - admin_permission_change
@@ -14782,6 +14784,57 @@ 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
+        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

descriptions/2.15/api.intercom.io.yaml

@@ -15233,6 +15233,8 @@ 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
           - admin_permission_change
@@ -15405,6 +15407,57 @@ 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
+        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

descriptions/2.16/api.intercom.io.yaml

@@ -792,6 +792,8 @@ 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
                     - admin_permission_change
@@ -22442,6 +22444,8 @@ 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
           - admin_permission_change
@@ -22635,6 +22639,57 @@ 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
+        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