List User Activity changedapi/beta/organization/analytics/users/list
Recorded here
Lines+64added
Lines−64removed
From line
35
where the diff opens
First seen
10 Sep 2026
this site's first read of the page
Recorded edits8to this page, all time
The whole hunk
from line 35, old and new numbered
/
from line 35
3535
3636 maxItems: 100
3737
38- `group_by: optional array of "rbac_group_id"`
38- `group_by: optional array of BetaAnalyticsUserGroupBy`
3939
4040 Dimensions to break results out by (e.g. `group_by[]=rbac_group_id`). Supported on this endpoint: `rbac_group_id`. Rows are already per-member, so the one supported grouping aggregates them per RBAC group instead. Grouped rows carry the requested dimension values as additional fields and paginate like ungrouped responses via `next_page`; an unsupported dimension returns 400. `rbac_group_id` attributes a user to every group they held at any point during each covered UTC day, so grouped rows are not an exclusive partition and can sum above org-level totals. At most 100 entries.
4141
from line 47
4747
4848 minimum: 1, maximum: 1000
4949
50- `order: optional "asc" or "desc"`
50- `order: optional BetaAnalyticsOrder`
5151
5252 Sort direction: `asc` or `desc`. Defaults to `asc` for the endpoint's sort column and to `desc` when `order_by` names a metric (a top-N ranking). Applies to `order_by`, or to the endpoint's default sort field when `order_by` is omitted.
5353
from line 221
221221
222222 Number of distinct connectors used in Cowork sessions. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
223223
224 - `distinct_plugins_used_count: number or null`
225
226 Number of distinct plugins used in Cowork sessions. Null while Cowork plugin-use metrics are not enabled for this organization. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
227
224228 - `distinct_session_count: number or null`
225229
226230 Number of distinct Cowork sessions. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
from line 233
229233
230234 Number of distinct skills used in Cowork sessions. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
231235
232 - `message_count: number`
236 - `edit_tool_count: number or null`
233237
234 Number of messages sent in Cowork sessions
235
236 - `skills_used_count: number`
237
238 Total number of skill invocations in Cowork sessions
239
240 - `distinct_plugins_used_count: optional number or null`
241
242 Number of distinct plugins used in Cowork sessions. Null while Cowork plugin-use metrics are not enabled for this organization. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
243
244 - `edit_tool_count: optional number or null`
245
246238 Number of successful Edit tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
247239
248 - `file_edit_count: optional number or null`
240 - `file_edit_count: number or null`
249241
250242 Number of successful file-edit tool calls (Edit, MultiEdit, Write, NotebookEdit) in Cowork sessions. Null, never 0, while the file-edit metrics are not enabled for this organization.
251243
252 - `multi_edit_tool_count: optional number or null`
244 - `message_count: number`
253245
246 Number of messages sent in Cowork sessions
247
248 - `multi_edit_tool_count: number or null`
249
254250 Number of successful MultiEdit tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
255251
256 - `notebook_edit_tool_count: optional number or null`
252 - `notebook_edit_tool_count: number or null`
257253
258254 Number of successful NotebookEdit tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
259255
260 - `plugins_used_count: optional number or null`
256 - `plugins_used_count: number or null`
261257
262258 Total number of plugin invocations in Cowork sessions. Null while Cowork plugin-use metrics are not enabled for this organization.
263259
264 - `sessions_with_file_edits_count: optional number or null`
260 - `sessions_with_file_edits_count: number or null`
265261
266262 Number of distinct Cowork sessions with at least one successful file-edit tool call. Null while the file-edit metrics are not enabled for this organization. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
267263
268 - `write_tool_count: optional number or null`
264 - `skills_used_count: number`
269265
266 Total number of skill invocations in Cowork sessions
267
268 - `write_tool_count: number or null`
269
270270 Number of successful Write tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
271271
272272 - `design_metrics: BetaAnalyticsDesignMetrics`
from line 289
289289
290290 Number of messages sent in Claude Design sessions
291291
292 - `distinct_user_count: number or null`
293
294 Number of distinct active users represented by this row. Only set for grouped rollups (`group_by[]`); null for per-user rows. In date-range mode, recomputed as an exact distinct count of the group's active members over the requested window, never a sum of per-day values.
295
292296 - `office_metrics: BetaAnalyticsOfficeMetrics`
293297
294298 Office Agent activity metrics for a single user on a given day, broken out by Office product.
from line 361
357361
358362 Total number of skill invocations in Claude Science sessions
359363
364 - `user: BetaAnalyticsUser or null`
365
366 The user this row describes. Null on rows aggregated across users.
367
368 - `type: "user"`
369
370 Object type. Always `user`.
371
372 default: user
373
374 - `id: string`
375
376 Tagged user identifier (e.g. `user_...`)
377
378 - `email_address: string`
379
380 Email address of the user
381
360382 - `web_search_count: number`
361383
362384 Number of web searches performed
363385
364 - `chat_cowork_unified_metrics: optional object or null`
386 - `chat_cowork_unified_metrics: optional BetaAnalyticsChatCoworkUnifiedMetrics or null`
365387
366388 Activity recorded while the member had Chat and Cowork unified (Cowork's features inside claude.ai chat) turned on, split into `chat` (chat activity) and `sessions` (Cowork activity). Omitted from the response on deployments that do not offer Chat and Cowork unified.
367389
from line 513
491513
492514 Same measure as `cowork_metrics.write_tool_count`, for activity recorded while members had Chat and Cowork unified turned on.
493515
494 - `distinct_user_count: optional number or null`
495
496 Number of distinct active users represented by this row. Only set for grouped rollups (`group_by[]`); null for per-user rows. In date-range mode, recomputed as an exact distinct count of the group's active members over the requested window, never a sum of per-day values.
497
498516 - `last_activity_date: optional string or null`
499517
500518 Most recent UTC day (YYYY-MM-DD) on which the user had any counted activity, within the requested window: equal to the requested `date` in single-day mode, and to the latest active day from `starting_date` (inclusive) to `ending_date` (exclusive) in date-range rollup mode — never a day earlier than the window start. On filtered requests (`filter[]`) only days matching the filter count: with `filter[]=rbac_group_id:{id}` it is the last day the user was active while a member of that group, consistent with the row's other metrics. On grouped (`group_by[]`) rows it is the latest day any member of the group was active (the requested `date` in single-day mode). Omitted from the response while last-activity reporting is not enabled for this organization.
from line 527
509527
510528 Resolved RBAC group display name, alongside `rbac_group_id` when name resolution is available. Null if the group has been deleted or its name could not be resolved; `rbac_group_id` remains the stable key.
511529
512 - `user: optional BetaAnalyticsUser or null`
513
514 The user this row describes. Null on rows aggregated across users.
515
516 - `type: "user"`
517
518 Object type. Always `user`.
519
520 default: user
521
522 - `id: string`
523
524 Tagged user identifier (e.g. `user_...`)
525
526 - `email_address: string`
527
528 Email address of the user
529
530530- `next_page: string or null`
531531
532532 Opaque cursor for the next page, or null if no more results
from line 595
595595 "connectors_used_count": 0,
596596 "dispatch_turn_count": 0,
597597 "distinct_connectors_used_count": 0,
598 "distinct_plugins_used_count": 0,
598599 "distinct_session_count": 0,
599600 "distinct_skills_used_count": 0,
600 "message_count": 0,
601 "skills_used_count": 0,
602 "distinct_plugins_used_count": 0,
603601 "edit_tool_count": 0,
604602 "file_edit_count": 0,
603 "message_count": 0,
605604 "multi_edit_tool_count": 0,
606605 "notebook_edit_tool_count": 0,
607606 "plugins_used_count": 0,
608607 "sessions_with_file_edits_count": 0,
608 "skills_used_count": 0,
609609 "write_tool_count": 0
610610 },
611611 "design_metrics": {
from line 614
614614 "distinct_session_count": 0,
615615 "message_count": 0
616616 },
617 "distinct_user_count": 0,
617618 "office_metrics": {
618619 "excel": {
619620 "connectors_used_count": 0,
from line 656
655656 "remote_compute_job_count": 0,
656657 "skills_used_count": 0
657658 },
659 "user": {
660 "id": "id",
661 "email_address": "email_address",
662 "type": "user"
663 },
658664 "web_search_count": 0,
659665 "chat_cowork_unified_metrics": {
660666 "chat": {
from line 697
691697 "write_tool_count": 0
692698 }
693699 },
694 "distinct_user_count": 0,
695700 "last_activity_date": "2019-12-27",
696701 "rbac_group_id": "rbac_group_id",
697 "rbac_group_name": "rbac_group_name",
698 "user": {
699 "id": "id",
700 "email_address": "email_address",
701 "type": "user"
702 }
702 "rbac_group_name": "rbac_group_name"
703703 }
704704 ],
705705 "next_page": "next_page"
No line in this hunk matches that.