Add monitoring admin activities endpoint to Unstable OpenAPI spec

Add GET /monitoring/admin_activities endpoint definition, schemas
(admin_activity, admin_activity_list), and Monitoring tag to the
Unstable (v0) spec.

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

Author: farukaydin

descriptions/0/api.intercom.io.yaml

@@ -12383,6 +12383,90 @@ paths:
                       message: Whatsapp message not found
               schema:
                 "$ref": "#/components/schemas/error"
+  "/monitoring/admin_activities":
+    get:
+      summary: List admin activity metrics
+      parameters:
+      - name: Intercom-Version
+        in: header
+        schema:
+          "$ref": "#/components/schemas/intercom_version"
+      - name: team_ids[]
+        in: query
+        required: true
+        description: A list of team IDs to retrieve admin activity metrics for. Use `GET /teams` to list available team IDs.
+        schema:
+          type: array
+          items:
+            type: string
+        example: ["42", "87"]
+      - name: idle_threshold
+        in: query
+        required: false
+        description: The number of seconds after which an open conversation is considered idle. Defaults to 1800 (30 minutes).
+        schema:
+          type: integer
+          default: 1800
+          example: 1800
+      tags:
+      - Monitoring
+      operationId: listAdminActivities
+      description: |
+        Returns real-time activity metrics for admins in the specified teams. For each admin, the response includes counts of open, idle, and snoozed conversations.
+
+        This endpoint requires the `realtime_monitoring` feature to be enabled for your workspace.
+      responses:
+        '200':
+          description: Successful response
+          content:
+            application/json:
+              examples:
+                Successful response:
+                  value:
+                    type: admin_activity.list
+                    data:
+                    - type: admin_activity
+                      admin_id: "123"
+                      open: 5
+                      idle: 2
+                      snoozed: 1
+                    - type: admin_activity
+                      admin_id: "456"
+                      open: 3
+                      idle: 0
+                      snoozed: 2
+              schema:
+                $ref: "#/components/schemas/admin_activity_list"
+        '400':
+          description: Bad request - missing team_ids parameter
+          content:
+            application/json:
+              examples:
+                Missing team_ids:
+                  value:
+                    type: error.list
+                    request_id: "req-123"
+                    errors:
+                    - code: parameter_not_found
+                      message: "team_ids is a required parameter. Use GET /teams to list available team IDs."
+              schema:
+                "$ref": "#/components/schemas/error"
+        '401':
+          "$ref": "#/components/responses/Unauthorized"
+        '403':
+          description: Feature not enabled
+          content:
+            application/json:
+              examples:
+                Feature disabled:
+                  value:
+                    type: error.list
+                    request_id: "req-456"
+                    errors:
+                    - code: api_plan_restricted
+                      message: "Real-time monitoring is not enabled for your workspace."
+              schema:
+                "$ref": "#/components/schemas/error"
   "/news/news_items":
     get:
       summary: List all news items
@@ -18600,6 +18684,40 @@ components:
                 "$ref": "#/components/schemas/customer_request"
             required:
             - email
+    admin_activity:
+      type: object
+      description: Activity metrics for an individual admin.
+      properties:
+        type:
+          type: string
+          example: "admin_activity"
+        admin_id:
+          type: string
+          description: The unique identifier for the admin.
+          example: "123"
+        open:
+          type: integer
+          description: The number of open conversations assigned to the admin.
+          example: 5
+        idle:
+          type: integer
+          description: The number of idle conversations assigned to the admin. A conversation is idle when it has been open and waiting for an admin reply longer than the idle_threshold.
+          example: 2
+        snoozed:
+          type: integer
+          description: The number of snoozed conversations assigned to the admin.
+          example: 1
+    admin_activity_list:
+      type: object
+      description: A list of admin activity metrics.
+      properties:
+        type:
+          type: string
+          example: "admin_activity.list"
+        data:
+          type: array
+          items:
+            $ref: "#/components/schemas/admin_activity"
     away_status_reason:
       type: object
       properties:
@@ -27387,6 +27505,8 @@ tags:
   x-displayName: Macros
 - name: Messages
   description: Everything about your messages
+- name: Monitoring
+  description: Real-time monitoring metrics for your workspace. Use these endpoints to track admin workload and conversation activity in real time.
 - name: News
   description: Everything about your News
   externalDocs: