Messages changedapi/compliance/apps/sessions/remote/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+66added
Lines−39removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits8to 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/sessions/remote/messages
4---
5
61# Messages
72
83## Retrieve remote session messages
94
10**get** `/v1/compliance/apps/sessions/remote/{claude_remote_session_id}/messages`
5**GET** `/v1/compliance/apps/sessions/remote/{claude_remote_session_id}/messages`
116
127Retrieve one remote session's transcript: user prompts, assistant
138responses, and tool calls and results. Thinking blocks and images are
from line 25
3025and for sessions outside the organizations the key may read. A
3126malformed session identifier returns 400.
3227
33### Path Parameters
28### Path parameters
3429
3530- `claude_remote_session_id: string`
3631
3732 The remote session identifier (`cse_...`) to retrieve
3833
39### Query Parameters
34### Query parameters
4035
4136- `limit: optional number`
4237
4338 Maximum results (default: 100, max: 1000)
4439
40 default: 100, maximum: 1000, minimum: 1
41
4542- `order: optional "asc" or "desc"`
4643
4744 Sort direction. `asc` (oldest-first) or `desc`.
4845
46 default: asc
47
4948 - `"asc"`
5049
5150 - `"desc"`
from line 57
5857
5958 Truncate each text item inside a tool result to at most this many bytes (cut on a code-point boundary). Pass `-1` to request the server maximum. `0` is not a valid value.
6059
60 default: 10000, maximum: 2147483647, minimum: -1
61
6162- `tool_use_input_max_bytes: optional number`
6263
6364 Truncate each tool-use input to at most this many bytes (cut on a code-point boundary so the result is valid UTF-8). Pass `-1` to request the server maximum. `0` is not a valid value.
6465
65### Header Parameters
66 default: 10000, maximum: 2147483647, minimum: -1
6667
68### Headers
69
6770- `"x-api-key": optional string`
6871
6972### Returns
7073
71- `data: array of object { id, content, content_unavailable, 3 more }`
74- `data: array of object`
7275
7376 Transcript turns for this page, ordered by transcript position. `created_at` is a commit timestamp and may tie or invert under concurrent writes; do not re-sort by it.
7477
from line 79
7679
7780 Unique identifier for the message, e.g. `csev_abc123`
7881
79 - `content: array of object { text, truncated, type } or object { id, input, name, 2 more } or object { content, is_error, name, 3 more }`
82 - `content: array of object or object or object`
8083
8184 Content blocks within the message
8285
83 - `Text object { text, truncated, type }`
86 - `Text object`
8487
8588 Text content block.
8689
from line 95
9295
9396 True when `text` exceeded the server-defined maximum (approximately 1 MiB) and was shortened.
9497
98 default: false
99
95100 - `type: "text"`
96101
97 - `"text"`
102 default: text
98103
99 - `ToolUse object { id, input, name, 2 more }`
104 - `ToolUse object`
100105
101106 Tool invocation requested by the assistant.
102107
from line 121
116121
117122 True when `input` was shortened. Pass `tool_use_input_max_bytes=-1` to request full content, subject to the server-side maximum.
118123
124 default: false
125
119126 - `type: "tool_use"`
120127
121 - `"tool_use"`
128 default: tool_use
122129
123 - `ToolResult object { content, is_error, name, 3 more }`
130 - `ToolResult object`
124131
125132 Result returned by a tool invocation.
126133
127 - `content: array of object { text, type }`
134 - `content: array of object`
128135
129136 Text content returned by the tool. Non-text item types are omitted.
130137
from line 141
134141
135142 - `type: "text"`
136143
137 - `"text"`
144 default: text
138145
139146 - `is_error: boolean`
140147
from line 159
152159
153160 True when one or more text items in `content` were shortened. Pass `tool_result_max_bytes=-1` to request full content, subject to the server-side maximum.
154161
162 default: false
163
155164 - `type: "tool_result"`
156165
157 - `"tool_result"`
166 default: tool_result
158167
159168 - `content_unavailable: boolean`
160169
161170 True when the stored content could not be returned — it could not be decrypted, or it exceeded the server's per-event size bound. `content` is empty in that case; this distinguishes 'no content' from 'content withheld'.
162171
172 default: false
173
163174 - `created_at: string`
164175
165176 When the message was recorded (RFC 3339, UTC)
166177
178 format: date-time
179
167180 - `role: "assistant" or "user"`
168181
169182 Message sender (`user` or `assistant`)
from line 193
180193
181194 Opaque page token; pass as `page` to retrieve the next page. Null when no rows exist after this page. Treat this value as opaque; do not parse or store it long-term, as the format may change without notice.
182195
183- `session: object { id, agent_id, claude_project_id, 7 more }`
196- `session: object`
184197
185198 Session metadata. `started_by_user`, `user.email_address`, and `claude_project_id` are always null on this endpoint; the messages endpoint resolves neither email addresses nor project bindings.
186199
from line 213
200213
201214 When the session was created (RFC 3339, UTC)
202215
216 format: date-time
217
203218 - `organization_uuid: string`
204219
205220 UUID of the organization the session belongs to
from line 223
208223
209224 The Claude product the session was created from. Currently `cowork_remote`, for Cowork sessions started on claude.ai web or mobile. More values will appear as other surfaces launch, so treat any unrecognized value as an unclassified surface rather than an error. Null for sessions created before this field was recorded, for surfaces that do not stamp it, and for unrecognized tag values.
210225
211 - `started_by_user: object { id, email_address } or null`
226 - `started_by_user: object or null`
212227
213228 A user associated with a remote session.
214229
from line 243
228243
229244 When the session was last modified (RFC 3339, UTC)
230245
231 - `user: object { id, email_address } or null`
246 format: date-time
232247
248 - `user: object or null`
249
233250 A user associated with a remote session.
234251
235252 - `id: string`
from line 259
242259
243260### Example
244261
245```http
262```bash
246263curl https://api.anthropic.com/v1/compliance/apps/sessions/remote/$CLAUDE_REMOTE_SESSION_ID/messages \
247264 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
248265```
249266
250#### Response
267#### Response (200)
251268
252269```json
253270{
from line 306
289306}
290307```
291308
292## Domain Types
309## Domain types
293310
294311### Message List Response
295312
296- `MessageListResponse object { id, content, content_unavailable, 3 more }`
313- `MessageListResponse object`
297314
298315 A single user or assistant turn in a remote session transcript.
299316
from line 321
304321
305322 Unique identifier for the message, e.g. `csev_abc123`
306323
307 - `content: array of object { text, truncated, type } or object { id, input, name, 2 more } or object { content, is_error, name, 3 more }`
324 - `content: array of object or object or object`
308325
309326 Content blocks within the message
310327
311 - `Text object { text, truncated, type }`
328 - `Text object`
312329
313330 Text content block.
314331
from line 337
320337
321338 True when `text` exceeded the server-defined maximum (approximately 1 MiB) and was shortened.
322339
340 default: false
341
323342 - `type: "text"`
324343
325 - `"text"`
344 default: text
326345
327 - `ToolUse object { id, input, name, 2 more }`
346 - `ToolUse object`
328347
329348 Tool invocation requested by the assistant.
330349
from line 363
344363
345364 True when `input` was shortened. Pass `tool_use_input_max_bytes=-1` to request full content, subject to the server-side maximum.
346365
366 default: false
367
347368 - `type: "tool_use"`
348369
349 - `"tool_use"`
370 default: tool_use
350371
351 - `ToolResult object { content, is_error, name, 3 more }`
372 - `ToolResult object`
352373
353374 Result returned by a tool invocation.
354375
355 - `content: array of object { text, type }`
376 - `content: array of object`
356377
357378 Text content returned by the tool. Non-text item types are omitted.
358379
from line 383
362383
363384 - `type: "text"`
364385
365 - `"text"`
386 default: text
366387
367388 - `is_error: boolean`
368389
from line 401
380401
381402 True when one or more text items in `content` were shortened. Pass `tool_result_max_bytes=-1` to request full content, subject to the server-side maximum.
382403
404 default: false
405
383406 - `type: "tool_result"`
384407
385 - `"tool_result"`
408 default: tool_result
386409
387410 - `content_unavailable: boolean`
388411
389412 True when the stored content could not be returned — it could not be decrypted, or it exceeded the server's per-event size bound. `content` is empty in that case; this distinguishes 'no content' from 'content withheld'.
390413
414 default: false
415
391416 - `created_at: string`
392417
393418 When the message was recorded (RFC 3339, UTC)
419
420 format: date-time
394421
395422 - `role: "assistant" or "user"`
396423
No line in this hunk matches that.