Messages changedapi/compliance/apps/chats/messages
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+121added
Lines−68removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits14to this page, all time
### Path parameters ### Query parameters ### Headers #### Response (200) ## Domain types ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Domain Types
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Messages
3url: https://platform.claude.com/docs/en/api/compliance/apps/chats/messages
4---
5
61# Messages
72
83## Get chat messages
94
10**get** `/v1/compliance/apps/chats/{claude_chat_id}/messages`
5**GET** `/v1/compliance/apps/chats/{claude_chat_id}/messages`
116
127Retrieves message history and file metadata for a specific chat.
138
14### Path Parameters
9### Path parameters
1510
1611- `claude_chat_id: string`
1712
1813 The chat ID (tagged ID, e.g., claude_chat_abc123)
1914
20### Query Parameters
15### Query parameters
2116
2217- `after_id: optional string`
2318
from line 22
2722
2823 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.
2924
30- `created_at: optional object { gt, gte, lt, lte }`
25- `created_at: optional object`
3126
3227 - `gt: optional string`
3328
3429 Filter messages created after this time (RFC 3339 format)
3530
31 format: date-time
32
3633 - `gte: optional string`
3734
3835 Filter messages created at or after this time (RFC 3339 format)
3936
37 format: date-time
38
4039 - `lt: optional string`
4140
4241 Filter messages created before this time (RFC 3339 format)
4342
43 format: date-time
44
4445 - `lte: optional string`
4546
4647 Filter messages created at or before this time (RFC 3339 format)
4748
49 format: date-time
50
4851- `limit: optional number`
4952
5053 Maximum results (max: 1000). When omitted, the full result set is returned in one response.
5154
55 maximum: 1000, minimum: 1
56
5257- `order: optional "asc" or "desc"`
5358
5459 Sort direction for messages within the response. `asc` (the default) returns oldest-first; `desc` returns newest-first.
5560
61 default: asc
62
5663 - `"asc"`
5764
5865 - `"desc"`
from line 68
6168
6269 Maximum characters returned per tool-result text item. Items longer than this are shortened and the block's `truncated` field is set. Pass -1 to disable the limit.
6370
71 default: 10000, minimum: -1
72
6473- `tool_use_input_max_chars: optional number`
6574
6675 Maximum characters of JSON-encoded tool input returned per tool_use block. Inputs longer than this are shortened and the block's `truncated` field is set. Pass -1 to disable the limit.
6776
68- `updated_at: optional object { gt, gte, lt, lte }`
77 default: 10000, minimum: -1
6978
79- `updated_at: optional object`
80
7081 - `gt: optional string`
7182
7283 Filter messages updated after this time (RFC 3339 format)
7384
85 format: date-time
86
7487 - `gte: optional string`
7588
7689 Filter messages updated at or after this time (RFC 3339 format)
7790
91 format: date-time
92
7893 - `lt: optional string`
7994
8095 Filter messages updated before this time (RFC 3339 format)
8196
97 format: date-time
98
8299 - `lte: optional string`
83100
84101 Filter messages updated at or before this time (RFC 3339 format)
85102
86### Header Parameters
103 format: date-time
87104
105### Headers
106
88107- `"x-api-key": optional string`
89108
90109### Returns
from line 112
93112
94113 Chat ID
95114
96- `chat_messages: array of object { id, artifacts, content, 4 more }`
115- `chat_messages: array of object`
97116
98117 Array of chat messages in order of created_at
99118
from line 120
101120
102121 Unique identifier for the message e.g. 'claude_chat_msg_abcd1234'
103122
104 - `artifacts: array of object { id, artifact_type, title, version_id } or null`
123 - `artifacts: array of object or null`
105124
106125 Versioned documents generated or updated by the assistant in this message. Download via `GET /v1/compliance/apps/artifacts/{artifact_version_id}/content`.
107126
from line 140
121140
122141 Artifact version ID e.g. 'claude_artifact_version_abc123'
123142
124 - `content: array of object { text, thinking_redacted, truncated, type } or object { id, input, integration_name, 4 more } or object { content, integration_name, is_error, 5 more }`
143 - `content: array of object or object or object`
125144
126145 Content blocks within the message
127146
128 - `Text object { text, thinking_redacted, truncated, type }`
147 - `Text object`
129148
130149 Text content block.
131150
from line 156
137156
138157 True when content enclosed in the assistant's internal-reasoning tags (or the tag markup itself) was removed from `text` during export. Removal never occurs with this field false. Always false on human messages, whose text is exported verbatim.
139158
159 default: false
160
140161 - `truncated: boolean`
141162
142163 True when `text` was shortened by the server's fixed per-string bound (1 MiB). Always false on chat text blocks.
143164
165 default: false
166
144167 - `type: "text"`
145168
146 - `"text"`
169 default: text
147170
148 - `ToolUse object { id, input, integration_name, 4 more }`
171 - `ToolUse object`
149172
150173 Tool invocation requested by the assistant.
151174
from line 196
173196
174197 True when `input` was shortened. Pass the endpoint's tool-use input max parameter as -1 to request full content, subject to any server-side maximum the endpoint enforces.
175198
199 default: false
200
176201 - `type: "tool_use"`
177202
178 - `"tool_use"`
203 default: tool_use
179204
180 - `ToolResult object { content, integration_name, is_error, 5 more }`
205 - `ToolResult object`
181206
182207 Result returned by a tool invocation.
183208
184 - `content: array of object { text, type }`
209 - `content: array of object`
185210
186211 Text content returned by the tool. Generated files are surfaced via the message's `generated_files` list; other non-text item types (including images and links) are omitted.
187212
from line 216
191216
192217 - `type: "text"`
193218
194 - `"text"`
219 default: text
195220
196221 - `integration_name: string or null`
197222
from line 242
217242
218243 True when one or more text items in `content` were shortened. Pass the endpoint's tool-result max parameter as -1 to request full content, subject to any server-side maximum the endpoint enforces.
219244
245 default: false
246
220247 - `type: "tool_result"`
221248
222 - `"tool_result"`
249 default: tool_result
223250
224251 - `created_at: string`
225252
226253 Message creation timestamp - For human: when they sent the message, For assistant: when it completed the last content block
227254
228 - `files: array of object { id, created_at, filename, 3 more } or null`
255 format: date-time
229256
257 - `files: array of object or null`
258
230259 Binary file attachments uploaded by the user. Download via `GET /v1/compliance/apps/chats/files/{claude_file_id}/content`.
231260
232261 - `id: string`
from line 266
237266
238267 File creation timestamp
239268
269 format: date-time
270
240271 - `filename: string`
241272
242273 Display name of the file
from line 284
253284
254285 Size in bytes of the file's preferred downloadable variant, if known. Null for older files uploaded before size was recorded.
255286
256 - `generated_files: array of object { id, filename, md5, 2 more } or null`
287 - `generated_files: array of object or null`
257288
258289 Downloadable files the assistant created via tool use (e.g. PDF, spreadsheet, slide deck). Distinct from `files`, which are uploads attached to the message. Download via `GET /v1/compliance/apps/chats/generated-files/{claude_gen_file_id}/content`.
259290
from line 320
289320
290321 Creation timestamp
291322
323 format: date-time
324
292325- `deleted_at: string or null`
293326
294327 Deletion timestamp if deleted
295328
329 format: date-time
330
296331- `first_id: string or null`
297332
298333 Opaque pagination cursor for the first message in the current result set. Pass as `before_id` on the next request to page backwards. 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 336
301336
302337 Whether more chat messages exist beyond the current result set. Use `last_id` as `after_id` in a follow-up request to page forward.
303338
339 default: false
340
304341- `href: string`
305342
306343 URL to view this chat in claude.ai
from line 354
317354
318355 Chat name
319356
320- `organization_id: string`
321
322 Organization ID this chat belongs to
323
324357- `organization_uuid: string`
325358
326359 Organization UUID this chat belongs to
from line 366
333366
334367 Last update timestamp
335368
336- `user: object { id, email_address } or null`
369 format: date-time
337370
371- `user: object or null`
372
338373 User information for compliance responses.
339374
340375 - `id: string`
from line 380
345380
346381 User's email address
347382
383- `organization_id: string`
384
385 **Deprecated**
386
387 Organization ID this chat belongs to
388
348389### Example
349390
350```http
391```bash
351392curl https://api.anthropic.com/v1/compliance/apps/chats/$CLAUDE_CHAT_ID/messages \
352393 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
353394```
354395
355#### Response
396#### Response (200)
356397
357398```json
358399{
from line 458
417458}
418459```
419460
420## Domain Types
461## Domain types
421462
422463### Message List Response
423464
424- `MessageListResponse object { id, artifacts, content, 4 more }`
465- `MessageListResponse object`
425466
426467 A single message in a chat conversation.
427468
from line 470
429470
430471 Unique identifier for the message e.g. 'claude_chat_msg_abcd1234'
431472
432 - `artifacts: array of object { id, artifact_type, title, version_id } or null`
473 - `artifacts: array of object or null`
433474
434475 Versioned documents generated or updated by the assistant in this message. Download via `GET /v1/compliance/apps/artifacts/{artifact_version_id}/content`.
435476
from line 490
449490
450491 Artifact version ID e.g. 'claude_artifact_version_abc123'
451492
452 - `content: array of object { text, thinking_redacted, truncated, type } or object { id, input, integration_name, 4 more } or object { content, integration_name, is_error, 5 more }`
493 - `content: array of object or object or object`
453494
454495 Content blocks within the message
455496
456 - `Text object { text, thinking_redacted, truncated, type }`
497 - `Text object`
457498
458499 Text content block.
459500
from line 506
465506
466507 True when content enclosed in the assistant's internal-reasoning tags (or the tag markup itself) was removed from `text` during export. Removal never occurs with this field false. Always false on human messages, whose text is exported verbatim.
467508
509 default: false
510
468511 - `truncated: boolean`
469512
470513 True when `text` was shortened by the server's fixed per-string bound (1 MiB). Always false on chat text blocks.
471514
515 default: false
516
472517 - `type: "text"`
473518
474 - `"text"`
519 default: text
475520
476 - `ToolUse object { id, input, integration_name, 4 more }`
521 - `ToolUse object`
477522
478523 Tool invocation requested by the assistant.
479524
from line 546
501546
502547 True when `input` was shortened. Pass the endpoint's tool-use input max parameter as -1 to request full content, subject to any server-side maximum the endpoint enforces.
503548
549 default: false
550
504551 - `type: "tool_use"`
505552
506 - `"tool_use"`
553 default: tool_use
507554
508 - `ToolResult object { content, integration_name, is_error, 5 more }`
555 - `ToolResult object`
509556
510557 Result returned by a tool invocation.
511558
512 - `content: array of object { text, type }`
559 - `content: array of object`
513560
514561 Text content returned by the tool. Generated files are surfaced via the message's `generated_files` list; other non-text item types (including images and links) are omitted.
515562
from line 566
519566
520567 - `type: "text"`
521568
522 - `"text"`
569 default: text
523570
524571 - `integration_name: string or null`
525572
from line 592
545592
546593 True when one or more text items in `content` were shortened. Pass the endpoint's tool-result max parameter as -1 to request full content, subject to any server-side maximum the endpoint enforces.
547594
595 default: false
596
548597 - `type: "tool_result"`
549598
550 - `"tool_result"`
599 default: tool_result
551600
552601 - `created_at: string`
553602
554603 Message creation timestamp - For human: when they sent the message, For assistant: when it completed the last content block
555604
556 - `files: array of object { id, created_at, filename, 3 more } or null`
605 format: date-time
557606
607 - `files: array of object or null`
608
558609 Binary file attachments uploaded by the user. Download via `GET /v1/compliance/apps/chats/files/{claude_file_id}/content`.
559610
560611 - `id: string`
from line 616
565616
566617 File creation timestamp
567618
619 format: date-time
620
568621 - `filename: string`
569622
570623 Display name of the file
from line 634
581634
582635 Size in bytes of the file's preferred downloadable variant, if known. Null for older files uploaded before size was recorded.
583636
584 - `generated_files: array of object { id, filename, md5, 2 more } or null`
637 - `generated_files: array of object or null`
585638
586639 Downloadable files the assistant created via tool use (e.g. PDF, spreadsheet, slide deck). Distinct from `files`, which are uploads attached to the message. Download via `GET /v1/compliance/apps/chats/generated-files/{claude_gen_file_id}/content`.
587640
No line in this hunk matches that.