Plugins changedapi/admin/analytics/plugins
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+27added
Lines−20removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits5to this page, all time
### Query parameters #### Response (200) ## Domain types ### Query Parameters #### Response ## Domain Types
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Plugins
3url: https://platform.claude.com/docs/en/api/admin/analytics/plugins
4---
5
61# Plugins
72
83## Get Plugin Usage
94
10**get** `/v1/organizations/analytics/plugins`
5**GET** `/v1/organizations/analytics/plugins`
116
127Get per-plugin install + invocation usage for a given day, with pagination.
138
from line 18
2318`read:analytics` scope. `starting_date` / `ending_date` select
2419range-rollup mode like /skills.
2520
26### Query Parameters
21### Query parameters
2722
2823- `date: optional string`
2924
3025 UTC date in YYYY-MM-DD format. The day to get plugin usage for. Data is typically available with a 1-day lag (varies by query; the error for a too-recent date names the latest available day) and may be revised by a few percent over the following days. No earlier than 2026-01-01.
3126
27 format: date
28
3229- `ending_date: optional string`
3330
3431 UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid with starting_date. Data is typically available with a 1-day lag (varies by query; the error for a too-recent date names the latest available day), so this can be at most today — which is also the default when omitted, resolved once when the first page is served and reused for the rest of the pagination sequence. At most 366 days after starting_date.
3532
33 format: date
34
3635- `filter: optional array of string`
3736
3837 Filters as 'dimension:value', e.g. filter[]=rbac_group_id:<id>. Repeat the param for OR within a dimension and across dimensions for AND. Supported dimensions on this endpoint: plugin_name, product, rbac_group_id, user_id. Value forms: plugin_name matches case-insensitively; product is claude_code or cowork (the only surfaces with plugin attribution); rbac_group_id takes the tagged id (rbac_group_..., as emitted in responses and by the spend-limits API) or a bare group UUID, and matches users who held the group at any point during each covered UTC day (time-of-usage attribution); user_id takes a tagged user id (user_...), as emitted in responses. An unsupported dimension returns 400. At most 100 entries.
3938
39 maxItems: 100
40
4041- `group_by: optional array of "product" or "rbac_group_id" or "user_id"`
4142
4243 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 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.
4344
45 maxItems: 100
46
4447 - `"product"`
4548
4649 - `"rbac_group_id"`
from line 54
5154
5255 Number of results per page (1-1000, default 100).
5356
57 minimum: 1, maximum: 1000
58
5459- `order: optional "asc" or "desc"`
5560
5661 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.
from line 76
7176
7277 UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup mode: one row per entity aggregated over the whole range — addable counters are summed across days, and a distinct count is never summed where summing could double-count (a field's range value is recomputed exactly over the window, approximate via HLL with typical error under 2%, null, or — for the creation-event counts, whose per-day values cannot overlap — a per-day sum that is itself exact; each field's own description says which). Use either date or starting_date, not both. Data is typically available with a 1-day lag (varies by query; the error for a too-recent date names the latest available day) and may be revised by a few percent over the following days. No earlier than 2026-01-01.
7378
79 format: date
80
7481### Returns
7582
76- `PluginUsage object { data, next_page }`
83- `PluginUsage object`
7784
7885 Response for GET /v1/organizations/analytics/plugins.
7986
80 - `data: array of object { claude_code_metrics, cowork_metrics, distinct_user_count, 8 more }`
87 - `data: array of object`
8188
82 - `claude_code_metrics: object { distinct_session_plugin_used_count }`
89 - `claude_code_metrics: object`
8390
8491 Claude Code activity metrics for a single plugin on a given day.
8592
from line 94
8794
8895 Number of distinct Claude Code sessions in which the plugin was invoked. Null on aggregated rows where a distinct count cannot be computed.
8996
90 - `cowork_metrics: object { distinct_session_plugin_used_count }`
97 - `cowork_metrics: object`
9198
9299 Cowork activity metrics for a single plugin on a given day.
93100
from line 144
137144
138145### Example
139146
140```http
147```bash
141148curl https://api.anthropic.com/v1/organizations/analytics/plugins \
142149 -H 'anthropic-version: 2023-06-01' \
143150 -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY"
144151```
145152
146#### Response
153#### Response (200)
147154
148155```json
149156{
from line 177
170177}
171178```
172179
173## Domain Types
180## Domain types
174181
175182### Plugin Usage
176183
177- `PluginUsage object { data, next_page }`
184- `PluginUsage object`
178185
179186 Response for GET /v1/organizations/analytics/plugins.
180187
181 - `data: array of object { claude_code_metrics, cowork_metrics, distinct_user_count, 8 more }`
188 - `data: array of object`
182189
183 - `claude_code_metrics: object { distinct_session_plugin_used_count }`
190 - `claude_code_metrics: object`
184191
185192 Claude Code activity metrics for a single plugin on a given day.
186193
from line 195
188195
189196 Number of distinct Claude Code sessions in which the plugin was invoked. Null on aggregated rows where a distinct count cannot be computed.
190197
191 - `cowork_metrics: object { distinct_session_plugin_used_count }`
198 - `cowork_metrics: object`
192199
193200 Cowork activity metrics for a single plugin on a given day.
194201
No line in this hunk matches that.