Organization changedapi/organization
Recorded here
Lines+4,708added
Lines−0removed
From line
8,884
where the diff opens
First seen
30 Sep 2026
this site's first read of the page
Recorded edits13to this page, all time
## Organization › Analytics › Summaries ### Get Activity Summaries ## Organization › Analytics › Users ### List User Activity ## Organization › Analytics › Apps › Chat › Projects ### Get Chat Project Usage ## Organization › Analytics › Connectors ### Get Connector Usage ## Organization › Analytics › Plugins ### Get Plugin Usage ## Organization › Analytics › Skills ### Get Skill Usage ## Organization › Analytics › Artifacts ### Get Artifact Activity ## Organization › Spend Limits › Effective ### List Effective Spend Limits ## Organization › Spend Limits › Increase Requests ### List Spend Limit Increase Requests ### Get Spend Limit Increase Request ### Approve Spend Limit Increase Request ### Deny Spend Limit Increase Request ## Organization › RBAC Groups ### Create RBAC Group ### List RBAC Groups ### Get RBAC Group ### Update RBAC Group ### Delete RBAC Group ## Organization › RBAC Groups › Members ### List RBAC Group Members ### Add RBAC Group Member ### Remove RBAC Group Member ## Organization › RBAC Roles ### List RBAC Roles ### Get RBAC Role ## Organization › RBAC Roles › Permissions ### List RBAC Role Permissions
The whole hunk
from line 8884, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 8884
88848884}
88858885```
88868886
8887## Organization › Analytics › Summaries
8888
8889### Get Activity Summaries
8890
8891**GET** `/v1/organizations/analytics/summaries`
8892
8893Get organization-wide activity summaries for a date range.
8894
8895Returns one entry per day from `starting_date` (inclusive) to `ending_date`
8896(exclusive) in `data`, the same `data` / `next_page` envelope as the other
8897analytics list endpoints; the series is currently returned in full, so
8898`next_page` is always null.
8899Data is typically available with a 1-day lag and may be revised by a few
8900percent over the following days: when `ending_date` is omitted it
8901defaults to the most recent available day + 1, so the last entry covers
8902the most recent available day. The series can be scoped to an RBAC group
8903via `filter[]=rbac_group_id:{id}`. Available to organizations on a Claude
8904Enterprise plan. Requires an API key with the `read:analytics` scope.
8905
8906#### Query parameters
8907
8908- `starting_date: string`
8909
8910 UTC date in YYYY-MM-DD format. Start of the date range (inclusive). 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.
8911
8912 format: date
8913
8914- `ending_date: optional string`
8915
8916 UTC date in YYYY-MM-DD format. End of the date range (exclusive). Data is typically available with a 1-day lag, so this can be at most today — which is also the default when omitted, making the last entry cover the most recent available day. Data may be revised by a few percent over the following days. The range may span at most 366 days.
8917
8918 format: date
8919
8920- `filter: optional array of string`
8921
8922 Filters as `dimension:value`. Only `rbac_group_id` is supported (e.g. `filter[]=rbac_group_id:{id}`); repeat the param to OR across groups. Scopes the whole day series to members of the matching group(s), re-aggregated from member-level activity — org-wide seat/invite fields and the adoption rates derived from them are null on scoped rows. `rbac_group_id` accepts 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 UTC day (time-of-usage attribution). At most 100 entries.
8923
8924 maxItems: 100
8925
8926- `limit: optional number`
8927
8928 Number of results per page (1-1000, default 100). The day series (at most 366 entries) is currently returned in full in a single page, so `limit` does not yet shorten it.
8929
8930 minimum: 1, maximum: 1000
8931
8932- `page: optional string`
8933
8934 Opaque cursor from a previous response's `next_page` field. `next_page` is currently always null, so there is never a cursor to send.
8935
8936#### Headers
8937
8938- `"anthropic-version": optional string`
8939
8940 The version of the Claude API you want to use.
8941
8942 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
8943
8944#### Returns
8945
8946- `data: array of AnalyticsSingleDayActivitySummary`
8947
8948 One entry per day in the requested range, ascending by date.
8949
8950 - `assigned_seat_count: number or null`
8951
8952 Number of seats currently assigned to members. Null when the response is scoped to an RBAC group — seat assignment is org-wide and has no per-group analogue.
8953
8954 - `cowork_daily_active_user_count: number`
8955
8956 Number of users with Cowork activity on the requested day
8957
8958 - `cowork_monthly_active_user_count: number`
8959
8960 Number of users with Cowork activity in the 30-day rolling window
8961
8962 - `cowork_weekly_active_user_count: number`
8963
8964 Number of users with Cowork activity in the 7-day rolling window
8965
8966 - `daily_active_user_count: number`
8967
8968 Number of users with token consumption on the requested day
8969
8970 - `daily_adoption_rate: number or null`
8971
8972 Percentage of assigned seats with activity on the requested day (`DAU / assigned_seat_count * 100`). Null when the response is scoped to an RBAC group.
8973
8974 - `ending_at: string`
8975
8976 End of the aggregation period (exclusive), UTC midnight in RFC 3339 format (e.g. `2026-01-16T00:00:00Z`).
8977
8978 format: date-time
8979
8980 - `monthly_active_user_count: number`
8981
8982 Number of users with token consumption in the 30-day rolling window
8983
8984 - `monthly_adoption_rate: number or null`
8985
8986 Percentage of assigned seats with activity in the 30-day rolling window (`MAU / assigned_seat_count * 100`). Null when the response is scoped to an RBAC group.
8987
8988 - `pending_invite_count: number or null`
8989
8990 Number of pending invitations to join the organization. Null when the response is scoped to an RBAC group.
8991
8992 - `starting_at: string`
8993
8994 Start of the aggregation period (inclusive), UTC midnight in RFC 3339 format (e.g. `2026-01-15T00:00:00Z`).
8995
8996 format: date-time
8997
8998 - `weekly_active_user_count: number`
8999
9000 Number of users with token consumption in the 7-day rolling window
9001
9002 - `weekly_adoption_rate: number or null`
9003
9004 Percentage of assigned seats with activity in the 7-day rolling window (`WAU / assigned_seat_count * 100`). Null when the response is scoped to an RBAC group.
9005
9006 - `chat_cowork_unified_daily_active_user_count: optional number or null`
9007
9008 Number of users with activity in Chat and Cowork unified on the requested day. Omitted from the response on deployments that do not offer Chat and Cowork unified.
9009
9010 - `chat_cowork_unified_monthly_active_user_count: optional number or null`
9011
9012 Number of users with activity in Chat and Cowork unified in the 28-day rolling window (30 days when the request filters by `rbac_group_id`). Omitted from the response on deployments that do not offer Chat and Cowork unified.
9013
9014 - `chat_cowork_unified_weekly_active_user_count: optional number or null`
9015
9016 Number of users with activity in Chat and Cowork unified in the 7-day rolling window. Omitted from the response on deployments that do not offer Chat and Cowork unified.
9017
9018 - `chat_daily_active_user_count: optional number or null`
9019
9020 Number of users with claude.ai (chat) activity on the requested day. Omitted from the response while the per-product breakdown is not enabled for this organization.
9021
9022 - `chat_monthly_active_user_count: optional number or null`
9023
9024 Number of users with claude.ai (chat) activity in the 30-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9025
9026 - `chat_weekly_active_user_count: optional number or null`
9027
9028 Number of users with claude.ai (chat) activity in the 7-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9029
9030 - `claude_code_daily_active_user_count: optional number or null`
9031
9032 Number of users with Claude Code activity on the requested day. Omitted from the response while the per-product breakdown is not enabled for this organization.
9033
9034 - `claude_code_monthly_active_user_count: optional number or null`
9035
9036 Number of users with Claude Code activity in the 30-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9037
9038 - `claude_code_weekly_active_user_count: optional number or null`
9039
9040 Number of users with Claude Code activity in the 7-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9041
9042 - `claude_design_daily_active_user_count: optional number or null`
9043
9044 Number of users with Claude Design activity on the requested day. Omitted from the response while the per-product breakdown is not enabled for this organization.
9045
9046 - `claude_design_monthly_active_user_count: optional number or null`
9047
9048 Number of users with Claude Design activity in the 30-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9049
9050 - `claude_design_weekly_active_user_count: optional number or null`
9051
9052 Number of users with Claude Design activity in the 7-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9053
9054 - `office_agent_daily_active_user_count: optional number or null`
9055
9056 Number of users with Claude in Office activity on the requested day. Omitted from the response while the per-product breakdown is not enabled for this organization.
9057
9058 - `office_agent_monthly_active_user_count: optional number or null`
9059
9060 Number of users with Claude in Office activity in the 30-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9061
9062 - `office_agent_weekly_active_user_count: optional number or null`
9063
9064 Number of users with Claude in Office activity in the 7-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9065
9066 - `science_daily_active_user_count: optional number or null`
9067
9068 Number of users with Claude Science activity on the requested day. Omitted from the response while the per-product breakdown is not enabled for this organization.
9069
9070 - `science_entitled_user_count: optional number or null`
9071
9072 Number of users with a Claude Science seat entitlement (per-seat RBAC) at the time of the daily snapshot. The funnel top; independent of the org-level Claude Science toggle. Null when the response is scoped to an RBAC group — entitlement is org-wide and has no per-group analogue. Omitted from the response while the per-product breakdown is not enabled for this organization.
9073
9074 - `science_monthly_active_user_count: optional number or null`
9075
9076 Number of users with Claude Science activity in the 30-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9077
9078 - `science_weekly_active_user_count: optional number or null`
9079
9080 Number of users with Claude Science activity in the 7-day rolling window. Omitted from the response while the per-product breakdown is not enabled for this organization.
9081
9082- `next_page: string or null`
9083
9084 Opaque cursor for the next page, or null if no more results. Currently always null: the day series is returned in full.
9085
9086#### Example
9087
9088```bash
9089curl https://api.anthropic.com/v1/organizations/analytics/summaries \
9090 -H 'anthropic-version: 2026-10-21' \
9091 -H "Authorization: Bearer $ANTHROPIC_API_KEY"
9092```
9093
9094##### Response (200)
9095
9096```json
9097{
9098 "data": [
9099 {
9100 "assigned_seat_count": 0,
9101 "cowork_daily_active_user_count": 0,
9102 "cowork_monthly_active_user_count": 0,
9103 "cowork_weekly_active_user_count": 0,
9104 "daily_active_user_count": 0,
9105 "daily_adoption_rate": 0,
9106 "ending_at": "2019-12-27T18:11:19.117Z",
9107 "monthly_active_user_count": 0,
9108 "monthly_adoption_rate": 0,
9109 "pending_invite_count": 0,
9110 "starting_at": "2019-12-27T18:11:19.117Z",
9111 "weekly_active_user_count": 0,
9112 "weekly_adoption_rate": 0,
9113 "chat_cowork_unified_daily_active_user_count": 0,
9114 "chat_cowork_unified_monthly_active_user_count": 0,
9115 "chat_cowork_unified_weekly_active_user_count": 0,
9116 "chat_daily_active_user_count": 0,
9117 "chat_monthly_active_user_count": 0,
9118 "chat_weekly_active_user_count": 0,
9119 "claude_code_daily_active_user_count": 0,
9120 "claude_code_monthly_active_user_count": 0,
9121 "claude_code_weekly_active_user_count": 0,
9122 "claude_design_daily_active_user_count": 0,
9123 "claude_design_monthly_active_user_count": 0,
9124 "claude_design_weekly_active_user_count": 0,
9125 "office_agent_daily_active_user_count": 0,
9126 "office_agent_monthly_active_user_count": 0,
9127 "office_agent_weekly_active_user_count": 0,
9128 "science_daily_active_user_count": 0,
9129 "science_entitled_user_count": 0,
9130 "science_monthly_active_user_count": 0,
9131 "science_weekly_active_user_count": 0
9132 }
9133 ],
9134 "next_page": "next_page"
9135}
9136```
9137
9138## Organization › Analytics › Users
9139
9140### List User Activity
9141
9142**GET** `/v1/organizations/analytics/users`
9143
9144Get per-user activity for a given day, with cursor-based pagination.
9145
9146Returns activity metrics for each user in the organization, sorted by email
9147address. Use `group_by[]` for per-RBAC-group aggregates, or `filter[]` to
9148scope results to specific members, groups, or a chat project. Available
9149to organizations on a Claude Enterprise plan. Requires an API key with
9150the `read:analytics` scope.
9151
9152#### Query parameters
9153
9154- `date: optional string`
9155
9156 UTC date in YYYY-MM-DD format. The day to get user activity 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.
9157
9158 format: date
9159
9160- `ending_date: optional string`
9161
9162 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`.
9163
9164 format: date
9165
9166- `filter: optional array of string`
9167
9168 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: `project_id`, `rbac_group_id`, `user_id`. Value forms: `project_id` takes a tagged project id (`claude_proj_...`); `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. A `project_id` filter limits each member's row to their claude.ai chat activity in that project and cannot be combined with `group_by[]` or an `rbac_group_id` filter. On these rows, every count in `chat_cowork_unified_metrics.sessions` is 0, because sessions are not measured per project. On any day a member sent a chat message in Chat and Cowork unified, all of that member's project activity for the day is counted in `chat_cowork_unified_metrics.chat` instead of `chat_metrics`.
9169
9170 maxItems: 100
9171
9172- `group_by: optional array of AnalyticsUserGroupBy`
9173
9174 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.
9175
9176 maxItems: 100
9177
9178- `limit: optional number`
9179
9180 Number of results per page (1-1000, default 100).
9181
9182 minimum: 1, maximum: 1000
9183
9184- `order: optional AnalyticsOrder`
9185
9186 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.
9187
9188 - `"asc"`
9189
9190 - `"desc"`
9191
9192- `order_by: optional string`
9193
9194 Sort field. Restricted to the endpoint's sort column plus its rankable metrics (metrics default to descending; a few metrics rank in date-range mode only, per the endpoint's documented orderable set).
9195
9196- `page: optional string`
9197
9198 Opaque cursor from a previous response's `next_page` field.
9199
9200- `starting_date: optional string`
9201
9202 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.
9203
9204 format: date
9205
9206#### Headers
9207
9208- `"anthropic-version": optional string`
9209
9210 The version of the Claude API you want to use.
9211
9212 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
9213
9214#### Returns
9215
9216- `data: array of AnalyticsUserActivity`
9217
9218 - `chat_metrics: AnalyticsChatMetrics`
9219
9220 Claude.ai activity metrics for a single user on a given day.
9221
9222 - `connectors_used_count: number`
9223
9224 Number of MCP connector invocations.
9225
9226 - `distinct_artifacts_created_count: number`
9227
9228 Number of distinct artifacts created. Exact in date-range mode: a creation belongs to exactly one day, so the per-day counts never overlap and their sum over the window is the exact count of distinct creations in it.
9229
9230 - `distinct_connectors_used_count: number or null`
9231
9232 Distinct claude.ai connectors this user used. Excludes calls whose connector could not be identified and all calls from organizations with zero data retention. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
9233
9234 - `distinct_conversation_count: number or null`
9235
9236 Number of distinct conversations the user participated in. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
9237
9238 - `distinct_files_uploaded_count: number or null`
9239
9240 Number of distinct files uploaded. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
9241
9242 - `distinct_projects_created_count: number`
9243
9244 Number of distinct projects created. Exact in date-range mode: a creation belongs to exactly one day, so the per-day counts never overlap and their sum over the window is the exact count of distinct creations in it.
9245
9246 - `distinct_projects_used_count: number or null`
9247
9248 Number of distinct projects used. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
9249
9250 - `distinct_shared_artifacts_viewed_count: number or null`
9251
9252 Number of distinct shared artifacts the user viewed. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
9253
9254 - `distinct_skills_used_count: number or null`
9255
9256 Number of distinct skills used. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
9257
9258 - `message_count: number`
9259
9260 Number of messages sent
9261
9262 - `shared_conversations_viewed_count: number`
9263
9264 Number of times the user opened a shared conversation in a project
9265
9266 - `thinking_message_count: number`
9267
9268 Number of messages that used extended thinking
9269
9270 - `claude_code_metrics: AnalyticsClaudeCodeMetrics`
9271
9272 Claude Code activity metrics for a single user on a given day.
9273
9274 - `core_metrics: AnalyticsCoreCodeMetrics`
9275
9276 Core Claude Code activity metrics for a single user on a given day.
9277
9278 - `artifacts_created_count: number`
9279
9280 Number of artifacts created in Claude Code sessions: an artifact counts once, on the day a session first saves it. Counted from 2026-08-17; 0 on earlier days. Exact in date-range mode: a creation belongs to exactly one day, so the per-day counts never overlap and their sum over the window is the exact count of distinct c
No line in this hunk matches that.