Remote changedapi/compliance/apps/sessions/remote
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+87added
Lines−163removed
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
### Query parameters ### Headers #### Response (200) ## Domain types ## Remote › Messages ### Retrieve remote session messages #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Query Parameters ### Header Parameters #### Response ## Domain Types # Messages ## Retrieve remote session messages ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Domain Types ### Message List Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Remote
3url: https://platform.claude.com/docs/en/api/compliance/apps/sessions/remote
4---
5
61# Remote
72
83## List remote sessions
94
10**get** `/v1/compliance/apps/sessions/remote`
5**GET** `/v1/compliance/apps/sessions/remote`
116
127List remote sessions (Cowork sessions that run in Anthropic-managed
138cloud environments) across the organizations the key may read.
from line 22
2722forward-only: pass the response's `next_page` value back as `page` to
2823retrieve the next page, and stop when `next_page` is null.
2924
30### Query Parameters
25### Query parameters
3126
32- `created_at: optional object { gt, gte, lt, lte }`
27- `created_at: optional object`
3328
3429 - `gt: optional string`
3530
3631 Filter remote sessions created after this time (RFC 3339 format)
3732
33 format: date-time
34
3835 - `gte: optional string`
3936
4037 Filter remote sessions created at or after this time (RFC 3339 format)
4138
39 format: date-time
40
4241 - `lt: optional string`
4342
4443 Filter remote sessions created before this time (RFC 3339 format)
4544
45 format: date-time
46
4647 - `lte: optional string`
4748
4849 Filter remote sessions created at or before this time (RFC 3339 format)
4950
51 format: date-time
52
5053- `limit: optional number`
5154
5255 Maximum results (default: 100, max: 500)
5356
57 default: 100, maximum: 500, minimum: 1
58
5459- `organization_ids: optional array of string`
5560
5661 Filter to specific child organization identifiers. Omit to enumerate every child organization the key may read.
5762
63 maxItems: 500
64
5865- `page: optional string`
5966
6067 Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. 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 70
6370
6471 Filter to sessions owned by specific users (max 10 per request). Agent-owned sessions are excluded when this filter is set.
6572
66### Header Parameters
73 maxItems: 10
6774
75### Headers
76
6877- `"x-api-key": optional string`
6978
7079### Returns
7180
72- `data: array of object { id, agent_id, claude_project_id, 7 more }`
81- `data: array of object`
7382
7483 - `id: string`
7584
from line 96
8796
8897 When the session was created (RFC 3339, UTC)
8998
99 format: date-time
100
90101 - `organization_uuid: string`
91102
92103 UUID of the organization the session belongs to
from line 106
95106
96107 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.
97108
98 - `started_by_user: object { id, email_address } or null`
109 - `started_by_user: object or null`
99110
100111 A user associated with a remote session.
101112
from line 126
115126
116127 When the session was last modified (RFC 3339, UTC)
117128
118 - `user: object { id, email_address } or null`
129 format: date-time
119130
131 - `user: object or null`
132
120133 A user associated with a remote session.
121134
122135 - `id: string`
from line 146
133146
134147### Example
135148
136```http
149```bash
137150curl https://api.anthropic.com/v1/compliance/apps/sessions/remote \
138151 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
139152```
140153
141#### Response
154#### Response (200)
142155
143156```json
144157{
from line 174
161174}
162175```
163176
164## Domain Types
177## Domain types
165178
166179### Remote List Response
167180
168- `RemoteListResponse object { id, agent_id, claude_project_id, 7 more }`
181- `RemoteListResponse object`
169182
170183 Metadata for one remote session, as returned in the list response
171184 and in the messages response's `session` field.
from line 202
189202
190203 When the session was created (RFC 3339, UTC)
191204
205 format: date-time
206
192207 - `organization_uuid: string`
193208
194209 UUID of the organization the session belongs to
from line 212
197212
198213 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.
199214
200 - `started_by_user: object { id, email_address } or null`
215 - `started_by_user: object or null`
201216
202217 A user associated with a remote session.
203218
from line 232
217232
218233 When the session was last modified (RFC 3339, UTC)
219234
220 - `user: object { id, email_address } or null`
235 format: date-time
221236
237 - `user: object or null`
238
222239 A user associated with a remote session.
223240
224241 - `id: string`
from line 246
229246
230247 User's email address. Null when the user is no longer a member of an organization the key may read — `id` remains set so attribution is preserved. The messages endpoint does not resolve email addresses; this field is always null there.
231248
232# Messages
249## Remote › Messages
233250
234## Retrieve remote session messages
251### Retrieve remote session messages
235252
236**get** `/v1/compliance/apps/sessions/remote/{claude_remote_session_id}/messages`
253**GET** `/v1/compliance/apps/sessions/remote/{claude_remote_session_id}/messages`
237254
238255Retrieve one remote session's transcript: user prompts, assistant
239256responses, and tool calls and results. Thinking blocks and images are
from line 273
256273and for sessions outside the organizations the key may read. A
257274malformed session identifier returns 400.
258275
259### Path Parameters
276#### Path parameters
260277
261278- `claude_remote_session_id: string`
262279
263280 The remote session identifier (`cse_...`) to retrieve
264281
265### Query Parameters
282#### Query parameters
266283
267284- `limit: optional number`
268285
269286 Maximum results (default: 100, max: 1000)
270287
288 default: 100, maximum: 1000, minimum: 1
289
271290- `order: optional "asc" or "desc"`
272291
273292 Sort direction. `asc` (oldest-first) or `desc`.
274293
294 default: asc
295
275296 - `"asc"`
276297
277298 - `"desc"`
from line 305
284305
285306 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.
286307
308 default: 10000, maximum: 2147483647, minimum: -1
309
287310- `tool_use_input_max_bytes: optional number`
288311
289312 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.
290313
291### Header Parameters
314 default: 10000, maximum: 2147483647, minimum: -1
292315
316#### Headers
317
293318- `"x-api-key": optional string`
294319
295### Returns
320#### Returns
296321
297- `data: array of object { id, content, content_unavailable, 3 more }`
322- `data: array of object`
298323
299324 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.
300325
from line 327
302327
303328 Unique identifier for the message, e.g. `csev_abc123`
304329
305 - `content: array of object { text, truncated, type } or object { id, input, name, 2 more } or object { content, is_error, name, 3 more }`
330 - `content: array of object or object or object`
306331
307332 Content blocks within the message
308333
309 - `Text object { text, truncated, type }`
334 - `Text object`
310335
311336 Text content block.
312337
from line 343
318343
319344 True when `text` exceeded the server-defined maximum (approximately 1 MiB) and was shortened.
320345
346 default: false
347
321348 - `type: "text"`
322349
323 - `"text"`
350 default: text
324351
325 - `ToolUse object { id, input, name, 2 more }`
352 - `ToolUse object`
326353
327354 Tool invocation requested by the assistant.
328355
from line 369
342369
343370 True when `input` was shortened. Pass `tool_use_input_max_bytes=-1` to request full content, subject to the server-side maximum.
344371
372 default: false
373
345374 - `type: "tool_use"`
346375
347 - `"tool_use"`
376 default: tool_use
348377
349 - `ToolResult object { content, is_error, name, 3 more }`
378 - `ToolResult object`
350379
351380 Result returned by a tool invocation.
352381
353 - `content: array of object { text, type }`
382 - `content: array of object`
354383
355384 Text content returned by the tool. Non-text item types are omitted.
356385
from line 389
360389
361390 - `type: "text"`
362391
363 - `"text"`
392 default: text
364393
365394 - `is_error: boolean`
366395
from line 407
378407
379408 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.
380409
410 default: false
411
381412 - `type: "tool_result"`
382413
383 - `"tool_result"`
414 default: tool_result
384415
385416 - `content_unavailable: boolean`
386417
387418 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'.
388419
420 default: false
421
389422 - `created_at: string`
390423
391424 When the message was recorded (RFC 3339, UTC)
392425
426 format: date-time
427
393428 - `role: "assistant" or "user"`
394429
395430 Message sender (`user` or `assistant`)
from line 441
406441
407442 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.
408443
409- `session: object { id, agent_id, claude_project_id, 7 more }`
444- `session: object`
410445
411446 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.
412447
from line 461
426461
427462 When the session was created (RFC 3339, UTC)
428463
464 format: date-time
465
429466 - `organization_uuid: string`
430467
431468 UUID of the organization the session belongs to
from line 471
434471
435472 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.
436473
437 - `started_by_user: object { id, email_address } or null`
474 - `started_by_user: object or null`
438475
439476 A user associated with a remote session.
440477
from line 491
454491
455492 When the session was last modified (RFC 3339, UTC)
456493
457 - `user: object { id, email_address } or null`
494 format: date-time
458495
496 - `user: object or null`
497
459498 A user associated with a remote session.
460499
461500 - `id: string`
from line 505
466505
467506 User's email address. Null when the user is no longer a member of an organization the key may read — `id` remains set so attribution is preserved. The messages endpoint does not resolve email addresses; this field is always null there.
468507
469### Example
508#### Example
470509
471```http
510```bash
472511curl https://api.anthropic.com/v1/compliance/apps/sessions/remote/$CLAUDE_REMOTE_SESSION_ID/messages \
473512 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
474513```
475514
476#### Response
515##### Response (200)
477516
478517```json
479518{
from line 553
514553 }
515554}
516555```
517
518## Domain Types
519
520### Message List Response
521
522- `MessageListResponse object { id, content, content_unavailable, 3 more }`
523
524 A single user or assistant turn in a remote session transcript.
525
526 `content` is a discriminated union of `text`, `tool_use`, and
527 `tool_result` blocks.
528
529 - `id: string`
530
531 Unique identifier for the message, e.g. `csev_abc123`
532
533 - `content: array of object { text, truncated, type } or object { id, input, name, 2 more } or object { content, is_error, name, 3 more }`
534
535 Content blocks within the message
536
537 - `Text object { text, truncated, type }`
538
539 Text content block.
540
541 - `text: string`
542
543 Text content from the user or the assistant
544
545 - `truncated: boolean`
546
547 True when `text` exceeded the server-defined maximum (approximately 1 MiB) and was shortened.
548
549 - `type: "text"`
550
551 - `"text"`
552
553 - `ToolUse object { id, input, name, 2 more }`
554
555 Tool invocation requested by the assistant.
556
557 - `id: string or null`
558
559 Tool-use ID, e.g. 'toolu_01AbC...'
560
561 - `input: string`
562
563 Arguments passed to the tool, as a JSON-encoded string. May be shortened — see the `truncated` field
564
565 - `name: string`
566
567 Name of the tool invoked
568
569 - `truncated: boolean`
570
571 True when `input` was shortened. Pass `tool_use_input_max_bytes=-1` to request full content, subject to the server-side maximum.
572
573 - `type: "tool_use"`
574
575 - `"tool_use"`
576
577 - `ToolResult object { content, is_error, name, 3 more }`
578
579 Result returned by a tool invocation.
580
581 - `content: array of object { text, type }`
582
583 Text content returned by the tool. Non-text item types are omitted.
584
585 - `text: string`
586
587 Text returned by the tool
588
589 - `type: "text"`
590
591 - `"text"`
592
593 - `is_error: boolean`
594
595 True when the tool reported an error
596
597 - `name: string`
598
599 Name of the tool that produced this result
600
601 - `tool_use_id: string or null`
602
603 ID of the tool_use block this result responds to
604
605 - `truncated: boolean`
606
607 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.
608
609 - `type: "tool_result"`
610
611 - `"tool_result"`
612
613 - `content_unavailable: boolean`
614
615 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'.
616
617 - `created_at: string`
618
619 When the message was recorded (RFC 3339, UTC)
620
621 - `role: "assistant" or "user"`
622
623 Message sender (`user` or `assistant`)
624
625 - `"assistant"`
626
627 - `"user"`
628
629 - `sent_by_user_id: string or null`
630
631 Identifier of the human account that sent this turn on an agent-owned session. Null on user-owned sessions, where every user-role turn was sent by the session's `user`.
632556
No line in this hunk matches that.