Users changedapi/beta/organization/analytics/users
Recorded here
Lines+64added
Lines−64removed
From line
37
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 37, old and new numbered
/
from line 37
3737
3838 maxItems: 100
3939
40- `group_by: optional array of "rbac_group_id"`
40- `group_by: optional array of BetaAnalyticsUserGroupBy`
4141
4242 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.
4343
from line 49
4949
5050 minimum: 1, maximum: 1000
5151
52- `order: optional "asc" or "desc"`
52- `order: optional BetaAnalyticsOrder`
5353
5454 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.
5555
from line 223
223223
224224 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.
225225
226 - `distinct_plugins_used_count: number or null`
227
228 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.
229
226230 - `distinct_session_count: number or null`
227231
228232 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 235
231235
232236 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.
233237
234 - `message_count: number`
238 - `edit_tool_count: number or null`
235239
236 Number of messages sent in Cowork sessions
237
238 - `skills_used_count: number`
239
240 Total number of skill invocations in Cowork sessions
241
242 - `distinct_plugins_used_count: optional number or null`
243
244 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.
245
246 - `edit_tool_count: optional number or null`
247
248240 Number of successful Edit tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
249241
250 - `file_edit_count: optional number or null`
242 - `file_edit_count: number or null`
251243
252244 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.
253245
254 - `multi_edit_tool_count: optional number or null`
246 - `message_count: number`
255247
248 Number of messages sent in Cowork sessions
249
250 - `multi_edit_tool_count: number or null`
251
256252 Number of successful MultiEdit tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
257253
258 - `notebook_edit_tool_count: optional number or null`
254 - `notebook_edit_tool_count: number or null`
259255
260256 Number of successful NotebookEdit tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
261257
262 - `plugins_used_count: optional number or null`
258 - `plugins_used_count: number or null`
263259
264260 Total number of plugin invocations in Cowork sessions. Null while Cowork plugin-use metrics are not enabled for this organization.
265261
266 - `sessions_with_file_edits_count: optional number or null`
262 - `sessions_with_file_edits_count: number or null`
267263
268264 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.
269265
270 - `write_tool_count: optional number or null`
266 - `skills_used_count: number`
271267
268 Total number of skill invocations in Cowork sessions
269
270 - `write_tool_count: number or null`
271
272272 Number of successful Write tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
273273
274274 - `design_metrics: BetaAnalyticsDesignMetrics`
from line 291
291291
292292 Number of messages sent in Claude Design sessions
293293
294 - `distinct_user_count: number or null`
295
296 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.
297
294298 - `office_metrics: BetaAnalyticsOfficeMetrics`
295299
296300 Office Agent activity metrics for a single user on a given day, broken out by Office product.
from line 363
359363
360364 Total number of skill invocations in Claude Science sessions
361365
366 - `user: BetaAnalyticsUser or null`
367
368 The user this row describes. Null on rows aggregated across users.
369
370 - `type: "user"`
371
372 Object type. Always `user`.
373
374 default: user
375
376 - `id: string`
377
378 Tagged user identifier (e.g. `user_...`)
379
380 - `email_address: string`
381
382 Email address of the user
383
362384 - `web_search_count: number`
363385
364386 Number of web searches performed
365387
366 - `chat_cowork_unified_metrics: optional object or null`
388 - `chat_cowork_unified_metrics: optional BetaAnalyticsChatCoworkUnifiedMetrics or null`
367389
368390 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.
369391
from line 515
493515
494516 Same measure as `cowork_metrics.write_tool_count`, for activity recorded while members had Chat and Cowork unified turned on.
495517
496 - `distinct_user_count: optional number or null`
497
498 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.
499
500518 - `last_activity_date: optional string or null`
501519
502520 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 529
511529
512530 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.
513531
514 - `user: optional BetaAnalyticsUser or null`
515
516 The user this row describes. Null on rows aggregated across users.
517
518 - `type: "user"`
519
520 Object type. Always `user`.
521
522 default: user
523
524 - `id: string`
525
526 Tagged user identifier (e.g. `user_...`)
527
528 - `email_address: string`
529
530 Email address of the user
531
532532- `next_page: string or null`
533533
534534 Opaque cursor for the next page, or null if no more results
from line 597
597597 "connectors_used_count": 0,
598598 "dispatch_turn_count": 0,
599599 "distinct_connectors_used_count": 0,
600 "distinct_plugins_used_count": 0,
600601 "distinct_session_count": 0,
601602 "distinct_skills_used_count": 0,
602 "message_count": 0,
603 "skills_used_count": 0,
604 "distinct_plugins_used_count": 0,
605603 "edit_tool_count": 0,
606604 "file_edit_count": 0,
605 "message_count": 0,
607606 "multi_edit_tool_count": 0,
608607 "notebook_edit_tool_count": 0,
609608 "plugins_used_count": 0,
610609 "sessions_with_file_edits_count": 0,
610 "skills_used_count": 0,
611611 "write_tool_count": 0
612612 },
613613 "design_metrics": {
from line 616
616616 "distinct_session_count": 0,
617617 "message_count": 0
618618 },
619 "distinct_user_count": 0,
619620 "office_metrics": {
620621 "excel": {
621622 "connectors_used_count": 0,
from line 658
657658 "remote_compute_job_count": 0,
658659 "skills_used_count": 0
659660 },
661 "user": {
662 "id": "id",
663 "email_address": "email_address",
664 "type": "user"
665 },
660666 "web_search_count": 0,
661667 "chat_cowork_unified_metrics": {
662668 "chat": {
from line 699
693699 "write_tool_count": 0
694700 }
695701 },
696 "distinct_user_count": 0,
697702 "last_activity_date": "2019-12-27",
698703 "rbac_group_id": "rbac_group_id",
699 "rbac_group_name": "rbac_group_name",
700 "user": {
701 "id": "id",
702 "email_address": "email_address",
703 "type": "user"
704 }
704 "rbac_group_name": "rbac_group_name"
705705 }
706706 ],
707707 "next_page": "next_page"
No line in this hunk matches that.