List chats changedapi/compliance/apps/chats/list
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+68added
Lines−43removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits10to this page, all time
# List chats ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List chats ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List chats
3url: https://platform.claude.com/docs/en/api/compliance/apps/chats/list
4---
1# List chats
52
6## List chats
3**GET** `/v1/compliance/apps/chats`
74
8**get** `/v1/compliance/apps/chats`
9
105Lists chat metadata with filtering capabilities for targeted
116compliance review. Results are sorted chronologically (time ascending)
127by the `order_by` key, with ties broken by id.
from line 15
2015no time filter) with the default `order_by`. `user_ids[]` with
2116`order_by=updated_at` is already rejected.
2217
23### Query Parameters
18## Query parameters
2419
2520- `after_id: optional string`
2621
from line 25
3025
3126 Pagination cursor for retrieving the previous page of results. To paginate, pass the `first_id` value from the most recent response. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
3227
33- `created_at: optional object { gt, gte, lt, lte }`
28- `created_at: optional object`
3429
3530 - `gt: optional string`
3631
3732 Filter chats created after this time (RFC 3339 format)
3833
34 format: date-time
35
3936 - `gte: optional string`
4037
4138 Filter chats created at or after this time (RFC 3339 format)
4239
40 format: date-time
41
4342 - `lt: optional string`
4443
4544 Filter chats created before this time (RFC 3339 format)
4645
46 format: date-time
47
4748 - `lte: optional string`
4849
4950 Filter chats created at or before this time (RFC 3339 format)
5051
52 format: date-time
53
5154- `limit: optional number`
5255
5356 Maximum results (default: 100, max: 1000)
5457
58 default: 100, maximum: 1000, minimum: 1
59
5560- `order_by: optional "created_at" or "updated_at"`
5661
5762 Sort key for results. `created_at` (default) sorts by chat creation time. `updated_at` sorts by last update time and is only supported for org-wide queries (omit user_ids[]). For org-wide queries, any time filter must match the sort key: `created_at.*` filters require `order_by=created_at`, and `updated_at.*` filters require `order_by=updated_at`.
5863
64 default: created_at
65
5966 - `"created_at"`
6067
6168 - `"updated_at"`
from line 75
6875
6976 Filter by project IDs (accepts `claude_proj_...`). Enumerate IDs via `GET /v1/compliance/apps/projects`. Requires user_ids[]; not supported for org-wide queries.
7077
71- `updated_at: optional object { gt, gte, lt, lte }`
78- `updated_at: optional object`
7279
7380 - `gt: optional string`
7481
7582 Filter chats updated after this time (RFC 3339 format). Combining updated_at filters with `user_ids[]` is deprecated and will be rejected after 2026-09-22; for updated_at-windowed polling, omit `user_ids[]` and use `order_by=updated_at` with `after_id` pagination.
7683
84 format: date-time
85
7786 - `gte: optional string`
7887
7988 Filter chats updated at or after this time (RFC 3339 format). Combining updated_at filters with `user_ids[]` is deprecated and will be rejected after 2026-09-22; for updated_at-windowed polling, omit `user_ids[]` and use `order_by=updated_at` with `after_id` pagination.
8089
90 format: date-time
91
8192 - `lt: optional string`
8293
8394 Filter chats updated before this time (RFC 3339 format). Combining updated_at filters with `user_ids[]` is deprecated and will be rejected after 2026-09-22; for updated_at-windowed polling, omit `user_ids[]` and use `order_by=updated_at` with `after_id` pagination.
8495
96 format: date-time
97
8598 - `lte: optional string`
8699
87100 Filter chats updated at or before this time (RFC 3339 format). Combining updated_at filters with `user_ids[]` is deprecated and will be rejected after 2026-09-22; for updated_at-windowed polling, omit `user_ids[]` and use `order_by=updated_at` with `after_id` pagination.
88101
102 format: date-time
103
89104- `user_ids: optional array of string`
90105
91106 Filter to chats created by specific users (max 10 per request). Omit for an org-wide query. Enumerate IDs via `GET /v1/compliance/organizations/{org_uuid}/users`. Deprecated combination: passing `user_ids[]` together with any `updated_at.*` filter is deprecated and will be rejected after 2026-09-22. For `updated_at`-windowed polling, omit `user_ids[]` and use `order_by=updated_at` with `after_id` pagination.
92107
93### Header Parameters
108 maxItems: 10
94109
110## Headers
111
95112- `"x-api-key": optional string`
96113
97### Returns
114## Returns
98115
99- `data: array of object { id, created_at, deleted_at, 8 more }`
116- `data: array of object`
100117
101118 List of chat metadata sorted chronologically by the request's `order_by` key (default `created_at`), tie break by id
102119
from line 125
108125
109126 Creation timestamp
110127
128 format: date-time
129
111130 - `deleted_at: string or null`
112131
113132 Deletion timestamp if deleted
114133
134 format: date-time
135
115136 - `href: string`
116137
117138 URL to view this chat in claude.ai
from line 145
124145
125146 Chat name/title
126147
127 - `organization_id: string`
128
129 Organization ID this chat belongs to
130
131148 - `organization_uuid: string`
132149
133150 Organization UUID this chat belongs to
from line 157
140157
141158 Last update timestamp
142159
143 - `user: object { id, email_address } or null`
160 format: date-time
144161
162 - `user: object or null`
163
145164 User information for compliance responses.
146165
147166 - `id: string`
from line 171
152171
153172 User's email address
154173
174 - `organization_id: string`
175
176 **Deprecated**
177
178 Organization ID this chat belongs to
179
155180- `first_id: string or null`
156181
157182 Opaque pagination cursor for the first chat in the current result set. Pass as `before_id` on the next request to page backwards. Backward pagination is only supported for per-user queries (`user_ids[]` set); org-wide queries do not accept `before_id`. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
from line 189
164189
165190 Opaque pagination cursor for the last chat in the current result set. Pass as `after_id` on the next request to page forwards. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
166191
167### Example
192## Example
168193
169```http
194```bash
170195curl https://api.anthropic.com/v1/compliance/apps/chats \
171196 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
172197```
173198
174#### Response
199### Response (200)
175200
176201```json
177202{
No line in this hunk matches that.