Get Plugin Usage changedapi/beta/organization/analytics/plugins/list
Recorded here
Lines+8added
Lines−8removed
From line
41
where the diff opens
First seen
10 Sep 2026
this site's first read of the page
Recorded edits7to this page, all time
The whole hunk
from line 41, old and new numbered
/
from line 41
4141
4242 maxItems: 100
4343
44- `group_by: optional array of "product" or "rbac_group_id" or "user_id"`
44- `group_by: optional array of BetaAnalyticsPluginGroupBy`
4545
4646 Dimensions to break results out by (e.g. `group_by[]=user_id`). Supported on this endpoint: `product`, `rbac_group_id`, `user_id`. On this endpoint `product` takes the values `chat_cowork_unified`, `claude_code`, or `cowork` only (the surfaces with plugin attribution). 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.
4747
from line 59
5959
6060 minimum: 1, maximum: 1000
6161
62- `order: optional "asc" or "desc"`
62- `order: optional BetaAnalyticsOrder`
6363
6464 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.
6565
from line 121
121121
122122 Number of plugin invocations on the requested day
123123
124 - `plugin_id: string or null`
125
126 Stable plugin identifier when available (e.g. `serena@claude-plugins-official`). Null for third-party Claude Code plugins (redacted at the source) and Cowork slash commands that carry only a hashed id.
127
124128 - `plugin_name: string`
125129
126130 Name of the plugin
127131
128 - `chat_cowork_unified_metrics: optional object or null`
132 - `chat_cowork_unified_metrics: optional BetaAnalyticsPluginChatCoworkUnifiedMetrics or null`
129133
130134 Plugin use recorded while members had Chat and Cowork unified (Cowork's features inside claude.ai chat) turned on. A count is null in date-range mode where it cannot be computed. Omitted from the response on deployments that do not offer Chat and Cowork unified.
131135
from line 137
133137
134138 Same measure as `cowork_metrics.distinct_session_plugin_used_count`, for activity recorded while members had Chat and Cowork unified turned on. Null on aggregated rows where a distinct count cannot be computed.
135139
136 - `plugin_id: optional string or null`
137
138 Stable plugin identifier when available (e.g. `serena@claude-plugins-official`). Null for third-party Claude Code plugins (redacted at the source) and Cowork slash commands that carry only a hashed id.
139
140140 - `product: optional string or null`
141141
142142 Product that produced this row's activity: one of `chat`, `claude_code`, `cowork`, `office_agent`, or `chat_cowork_unified` (Chat and Cowork unified). These are the canonical Cost & Usage product names; an `office_agent` row's per-surface breakdown is in its `office_metrics`. On `/plugins` only `cowork`, `claude_code` and `chat_cowork_unified` occur (the only surfaces with plugin attribution); on `/artifacts` only `chat`, `claude_code`, `cowork` and `chat_cowork_unified` occur (the surfaces that create artifacts); `/apps/chat/projects` does not support the product dimension (a `product` entry in `group_by[]` or `filter[]` there is rejected). Present only when the request grouped by `product`.
from line 180
180180 "distinct_user_count": 0,
181181 "install_count": 0,
182182 "invocation_count": 0,
183 "plugin_id": "plugin_id",
183184 "plugin_name": "plugin_name",
184185 "chat_cowork_unified_metrics": {
185186 "distinct_session_plugin_used_count": 0
186187 },
187 "plugin_id": "plugin_id",
188188 "product": "product",
189189 "rbac_group_id": "rbac_group_id",
190190 "rbac_group_name": "rbac_group_name",
No line in this hunk matches that.