Get Chat Project Usage changedapi/beta/organization/analytics/apps/chat/projects/list
Recorded here
Lines+23added
Lines−28removed
From line
35
where the diff opens
First seen
1 Oct 2026
this site's first read of the page
Recorded edits6to 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" or "user_id"`
38- `group_by: optional array of BetaAnalyticsProjectGroupBy`
3939
4040 Dimensions to break results out by (e.g. `group_by[]=user_id`). Supported on this endpoint: `rbac_group_id`, `user_id`. 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 51
5151
5252 minimum: 1, maximum: 1000
5353
54- `order: optional "asc" or "desc"`
54- `order: optional BetaAnalyticsOrder`
5555
5656 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.
5757
from line 85
8585
8686- `data: array of BetaAnalyticsProjectActivity`
8787
88 - `distinct_user_count: number`
88 - `created_at: string or null`
8989
90 Number of distinct users who used the project on the requested day, or, in date-range mode, over the requested window — recomputed as an exact distinct count over the window's per-member daily rows, never a sum of per-day values.
91
92 - `message_count: number`
93
94 Number of messages sent in the project on the requested day
95
96 - `project_id: string`
97
98 Tagged project identifier (e.g. `claude_proj_...`)
99
100 - `project_name: string`
101
102 Name of the project
103
104 - `created_at: optional string or null`
105
10690 Project creation timestamp in RFC 3339 format. Null if the project was deleted before attribution was recorded.
10791
10892 format: date-time
10993
110 - `created_by: optional BetaAnalyticsUser or null`
94 - `created_by: BetaAnalyticsUser or null`
11195
11296 User who created the project. Null if the project was deleted before attribution was recorded, or if the creator's account no longer exists.
11397
from line 109
125109
126110 Email address of the user
127111
128 - `distinct_conversation_count: optional number or null`
112 - `distinct_conversation_count: number or null`
129113
130114 Number of distinct conversations in the project. Null on aggregated rows where a distinct count cannot be computed.
131115
132 - `product: optional string or null`
116 - `distinct_user_count: number`
133117
134 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`.
118 Number of distinct users who used the project on the requested day, or, in date-range mode, over the requested window — recomputed as an exact distinct count over the window's per-member daily rows, never a sum of per-day values.
135119
120 - `message_count: number`
121
122 Number of messages sent in the project on the requested day
123
124 - `project_id: string`
125
126 Tagged project identifier (e.g. `claude_proj_...`)
127
128 - `project_name: string`
129
130 Name of the project
131
136132 - `rbac_group_id: optional string or null`
137133
138134 Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API spelling. Present only when the request grouped by `rbac_group_id`.
from line 159
163159{
164160 "data": [
165161 {
166 "distinct_user_count": 0,
167 "message_count": 0,
168 "project_id": "project_id",
169 "project_name": "project_name",
170162 "created_at": "2019-12-27T18:11:19.117Z",
171163 "created_by": {
172164 "id": "id",
from line 166
174166 "type": "user"
175167 },
176168 "distinct_conversation_count": 0,
177 "product": "product",
169 "distinct_user_count": 0,
170 "message_count": 0,
171 "project_id": "project_id",
172 "project_name": "project_name",
178173 "rbac_group_id": "rbac_group_id",
179174 "rbac_group_name": "rbac_group_name",
180175 "user_id": "user_id"
No line in this hunk matches that.