Send Events changedapi/beta/sessions/events/send
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+155added
Lines−170removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits22to this page, all time
# Send Events ## Path parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Send Events ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Send Events
3url: https://platform.claude.com/docs/en/api/beta/sessions/events/send
4---
1# Send Events
52
6## Send Events
3**POST** `/v1/sessions/{session_id}/events`
74
8**post** `/v1/sessions/{session_id}/events`
9
105Send Events
116
12### Path Parameters
7## Path parameters
138
149- `session_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Body Parameters
89## Body parameters
9590
9691- `events: array of BetaManagedAgentsEventParams`
9792
9893 Events to send to the `session`.
9994
100 - `BetaManagedAgentsUserMessageEventParams object { content, type }`
95 - `BetaManagedAgentsUserMessageEventParams object`
10196
10297 Parameters for sending a user message to the session.
10398
from line 100
105100
106101 Array of content blocks for the user message.
107102
108 - `BetaManagedAgentsTextBlock object { text, type }`
103 - `BetaManagedAgentsTextBlock object`
109104
110105 Regular text content.
111106
from line 108
113108
114109 The text content.
115110
111 minLength: 1
112
116113 - `type: "text"`
117114
118 - `"text"`
115 - `BetaManagedAgentsImageBlock object`
119116
120 - `BetaManagedAgentsImageBlock object { source, type }`
121
122117 Image content specified directly as base64 data or as a reference via a URL.
123118
124119 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
from line 120
125120
126121 Union type for image source variants.
127122
128 - `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
123 - `BetaManagedAgentsBase64ImageSource object`
129124
130125 Base64-encoded image data.
131126
from line 128
133128
134129 Base64-encoded image data.
135130
131 minLength: 1
132
136133 - `media_type: string`
137134
138135 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
139136
137 minLength: 1
138
140139 - `type: "base64"`
141140
142 - `"base64"`
141 - `BetaManagedAgentsURLImageSource object`
143142
144 - `BetaManagedAgentsURLImageSource object { type, url }`
145
146143 Image referenced by URL.
147144
148145 - `type: "url"`
149146
150 - `"url"`
151
152147 - `url: string`
153148
154149 URL of the image to fetch.
155150
156 - `BetaManagedAgentsFileImageSource object { file_id, type }`
151 minLength: 1
157152
153 - `BetaManagedAgentsFileImageSource object`
154
158155 Image referenced by file ID.
159156
160157 - `file_id: string`
from line 158
161158
162159 ID of a previously uploaded file.
163160
161 minLength: 1
162
164163 - `type: "file"`
165164
166 - `"file"`
167
168165 - `type: "image"`
169166
170 - `"image"`
167 - `BetaManagedAgentsDocumentBlock object`
171168
172 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
173
174169 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
175170
176171 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
from line 172
177172
178173 Union type for document source variants.
179174
180 - `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
175 - `BetaManagedAgentsBase64DocumentSource object`
181176
182177 Base64-encoded document data.
183178
from line 180
185180
186181 Base64-encoded document data.
187182
183 minLength: 1
184
188185 - `media_type: string`
189186
190187 MIME type of the document (e.g., "application/pdf").
191188
189 minLength: 1
190
192191 - `type: "base64"`
193192
194 - `"base64"`
193 - `BetaManagedAgentsPlainTextDocumentSource object`
195194
196 - `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
197
198195 Plain text document content.
199196
200197 - `data: string`
from line 198
201198
202199 The plain text content.
203200
201 minLength: 1
202
204203 - `media_type: "text/plain"`
205204
206205 MIME type of the text content. Must be "text/plain".
207206
208 - `"text/plain"`
209
210207 - `type: "text"`
211208
212 - `"text"`
209 - `BetaManagedAgentsURLDocumentSource object`
213210
214 - `BetaManagedAgentsURLDocumentSource object { type, url }`
215
216211 Document referenced by URL.
217212
218213 - `type: "url"`
219214
220 - `"url"`
221
222215 - `url: string`
223216
224217 URL of the document to fetch.
225218
226 - `BetaManagedAgentsFileDocumentSource object { file_id, type }`
219 minLength: 1
227220
221 - `BetaManagedAgentsFileDocumentSource object`
222
228223 Document referenced by file ID.
229224
230225 - `file_id: string`
from line 226
231226
232227 ID of a previously uploaded file.
233228
229 minLength: 1
230
234231 - `type: "file"`
235232
236 - `"file"`
237
238233 - `type: "document"`
239234
240 - `"document"`
241
242235 - `context: optional string or null`
243236
244237 Additional context about the document for the model.
from line 240
247240
248241 The title of the document.
249242
250 - `BetaManagedAgentsRedactedBlock object { type }`
243 - `BetaManagedAgentsRedactedBlock object`
251244
252245 Placeholder for content withheld by Anthropic model policy.
253246
254247 - `type: "redacted"`
255248
256 - `"redacted"`
257
258249 - `type: "user.message"`
259250
260 - `"user.message"`
251 - `BetaManagedAgentsUserInterruptEventParams object`
261252
262 - `BetaManagedAgentsUserInterruptEventParams object { type, session_thread_id }`
263
264253 Parameters for sending an interrupt to pause the agent.
265254
266255 - `type: "user.interrupt"`
267256
268 - `"user.interrupt"`
269
270257 - `session_thread_id: optional string or null`
271258
272259 If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
273260
274 - `BetaManagedAgentsUserToolConfirmationEventParams object { result, tool_use_id, type, deny_message }`
261 - `BetaManagedAgentsUserToolConfirmationEventParams object`
275262
276263 Parameters for confirming or denying a tool execution request.
277264
from line 274
287274
288275 The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
289276
277 minLength: 1, maxLength: 128
278
290279 - `type: "user.tool_confirmation"`
291280
292 - `"user.tool_confirmation"`
293
294281 - `deny_message: optional string or null`
295282
296283 Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.
297284
298 - `BetaManagedAgentsUserCustomToolResultEventParams object { custom_tool_use_id, type, content, is_error }`
285 maxLength: 10000
299286
287 - `BetaManagedAgentsUserCustomToolResultEventParams object`
288
300289 Parameters for providing the result of a custom tool execution.
301290
302291 - `custom_tool_use_id: string`
from line 292
303292
304293 The id of the `agent.custom_tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
305294
295 minLength: 1, maxLength: 128
296
306297 - `type: "user.custom_tool_result"`
307298
308 - `"user.custom_tool_result"`
309
310299 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
311300
312301 The result content returned by the tool.
313302
314 - `BetaManagedAgentsTextBlock object { text, type }`
303 - `BetaManagedAgentsTextBlock object`
315304
316305 Regular text content.
317306
318 - `BetaManagedAgentsImageBlock object { source, type }`
307 - `BetaManagedAgentsImageBlock object`
319308
320309 Image content specified directly as base64 data or as a reference via a URL.
321310
322 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
311 - `BetaManagedAgentsDocumentBlock object`
323312
324313 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
325314
326 - `BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }`
315 - `BetaManagedAgentsSearchResultBlock object`
327316
328317 A block containing a web search result.
329318
from line 332
343332
344333 The text content.
345334
335 minLength: 1
336
346337 - `type: "text"`
347338
348 - `"text"`
349
350339 - `source: string`
351340
352341 The URL source of the search result.
353342
343 minLength: 1
344
354345 - `title: string`
355346
356347 The title of the search result.
357348
349 minLength: 1
350
358351 - `type: "search_result"`
359352
360 - `"search_result"`
361
362353 - `is_error: optional boolean or null`
363354
364355 Whether the tool execution resulted in an error.
365356
366 - `BetaManagedAgentsUserDefineOutcomeEventParams object { description, rubric, type, max_iterations }`
357 - `BetaManagedAgentsUserDefineOutcomeEventParams object`
367358
368359 Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.
369360
from line 366
375366
376367 Rubric for grading the quality of an outcome.
377368
378 - `BetaManagedAgentsFileRubricParams object { file_id, type }`
369 - `BetaManagedAgentsFileRubricParams object`
379370
380371 Rubric referenced by a file uploaded via the Files API.
381372
from line 376
385376
386377 - `type: "file"`
387378
388 - `"file"`
379 - `BetaManagedAgentsTextRubricParams object`
389380
390 - `BetaManagedAgentsTextRubricParams object { content, type }`
391
392381 Rubric content provided inline as text.
393382
394383 - `content: string`
from line 384
395384
396385 Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.
397386
387 maxLength: 262144
388
398389 - `type: "text"`
399390
400 - `"text"`
401
402391 - `type: "user.define_outcome"`
403392
404 - `"user.define_outcome"`
405
406393 - `max_iterations: optional number or null`
407394
408395 Eval→revision cycles before giving up. Default 3, max 20.
409396
410 - `BetaManagedAgentsUserToolResultEventParams object { tool_use_id, type, content, is_error }`
397 format: int32
411398
399 - `BetaManagedAgentsUserToolResultEventParams object`
400
412401 Parameters for providing the result of an agent-toolset tool execution. Only valid on `self_hosted` environments, where sandbox-routed tools are executed by the client rather than the server.
413402
414403 - `tool_use_id: string`
from line 404
415404
416405 The id of the `agent.tool_use` event this result corresponds to, which can be found in the last `session.status_idle` [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids) `stop_reason.event_ids` field.
417406
407 minLength: 1, maxLength: 128
408
418409 - `type: "user.tool_result"`
419410
420 - `"user.tool_result"`
421
422411 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
423412
424413 The result content returned by the tool.
425414
426 - `BetaManagedAgentsTextBlock object { text, type }`
415 - `BetaManagedAgentsTextBlock object`
427416
428417 Regular text content.
429418
430 - `BetaManagedAgentsImageBlock object { source, type }`
419 - `BetaManagedAgentsImageBlock object`
431420
432421 Image content specified directly as base64 data or as a reference via a URL.
433422
434 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
423 - `BetaManagedAgentsDocumentBlock object`
435424
436425 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
437426
438 - `BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }`
427 - `BetaManagedAgentsSearchResultBlock object`
439428
440429 A block containing a web search result.
441430
from line 432
443432
444433 Whether the tool execution resulted in an error.
445434
446 - `BetaManagedAgentsSystemMessageEventParams object { content, type }`
435 - `BetaManagedAgentsSystemMessageEventParams object`
447436
448437 Privileged context for the accompanying turn and all subsequent turns, appended to the session's system context as a `role: "system"` turn rather than replacing the top-level system prompt. At most one per request: it must be the final event and immediately follow the `user.message`, `user.tool_result`, or `user.custom_tool_result` it accompanies. Only supported on models that accept mid-conversation system messages.
449438
from line 444
455444
456445 The text content.
457446
447 minLength: 1
448
458449 - `type: "text"`
459450
460 - `"text"`
461
462451 - `type: "system.message"`
463452
464 - `"system.message"`
453## Returns
465454
466### Returns
455- `BetaManagedAgentsSendSessionEvents object`
467456
468- `BetaManagedAgentsSendSessionEvents object { data }`
469
470457 Events that were successfully sent to the session.
471458
472459 - `data: optional array of BetaManagedAgentsUserMessageEvent or BetaManagedAgentsUserInterruptEvent or BetaManagedAgentsUserToolConfirmationEvent or 4 more`
from line 460
473460
474461 Sent events
475462
476 - `BetaManagedAgentsUserMessageEvent object { id, content, type, processed_at }`
463 - `BetaManagedAgentsUserMessageEvent object`
477464
478465 A user message event in the session conversation.
479466
from line 472
485472
486473 Array of content blocks comprising the user message.
487474
488 - `BetaManagedAgentsTextBlock object { text, type }`
475 - `BetaManagedAgentsTextBlock object`
489476
490477 Regular text content.
491478
from line 480
493480
494481 The text content.
495482
483 minLength: 1
484
496485 - `type: "text"`
497486
498 - `"text"`
487 - `BetaManagedAgentsImageBlock object`
499488
500 - `BetaManagedAgentsImageBlock object { source, type }`
501
502489 Image content specified directly as base64 data or as a reference via a URL.
503490
504491 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
from line 492
505492
506493 Union type for image source variants.
507494
508 - `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
495 - `BetaManagedAgentsBase64ImageSource object`
509496
510497 Base64-encoded image data.
511498
from line 500
513500
514501 Base64-encoded image data.
515502
503 minLength: 1
504
516505 - `media_type: string`
517506
518507 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
519508
509 minLength: 1
510
520511 - `type: "base64"`
521512
522 - `"base64"`
513 - `BetaManagedAgentsURLImageSource object`
523514
524 - `BetaManagedAgentsURLImageSource object { type, url }`
525
526515 Image referenced by URL.
527516
528517 - `type: "url"`
529518
530 - `"url"`
531
532519 - `url: string`
533520
534521 URL of the image to fetch.
535522
536 - `BetaManagedAgentsFileImageSource object { file_id, type }`
523 minLength: 1
537524
525 - `BetaManagedAgentsFileImageSource object`
526
538527 Image referenced by file ID.
539528
540529 - `file_id: string`
from line 530
541530
542531 ID of a previously uploaded file.
543532
533 minLength: 1
534
544535 - `type: "file"`
545536
546 - `"file"`
547
548537 - `type: "image"`
549538
550 - `"image"`
539 - `BetaManagedAgentsDocumentBlock object`
551540
552 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
553
554541 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
555542
556543 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
from line 544
557544
558545 Union type for document source variants.
559546
560 - `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
547 - `BetaManagedAgentsBase64DocumentSource object`
561548
562549 Base64-encoded document data.
563550
from line 552
565552
566553 Base64-encoded document data.
567554
555 minLength: 1
556
568557 - `media_type: string`
569558
570559 MIME type of the document (e.g., "application/pdf").
571560
561 minLength: 1
562
572563 - `type: "base64"`
573564
574 - `"base64"`
565 - `BetaManagedAgentsPlainTextDocumentSource object`
575566
576 - `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
577
578567 Plain text document content.
579568
580569 - `data: string`
from line 570
581570
582571 The plain text content.
583572
573 minLength: 1
574
584575 - `media_type: "text/plain"`
585576
586577 MIME type of the text content. Must be "text/plain".
587578
588 - `"text/plain"`
589
590579 - `type: "text"`
591580
592 - `"text"`
581 - `BetaManagedAgentsURLDocumentSource object`
593582
594 - `BetaManagedAgentsURLDocumentSource object { type, url }`
595
596583 Document referenced by URL.
597584
598585 - `type: "url"`
599586
600 - `"url"`
601
602587 - `url: string`
603588
604589 URL of the document to fetch.
605590
606 - `BetaManagedAgentsFileDocumentSource object { file_id, type }`
591 minLength: 1
607592
593 - `BetaManagedAgentsFileDocumentSource object`
594
608595 Document referenced by file ID.
609596
610597 - `file_id: string`
from line 598
611598
612599 ID of a previously uploaded file.
613600
601 minLength: 1
602
614603 - `type: "file"`
615604
616 - `"file"`
617
618605 - `type: "document"`
619606
620 - `"document"`
621
622607 - `context: optional string or null`
623608
624609 Additional context about the document for the model.
from line 612
627612
628613 The title of the document.
629614
630 - `BetaManagedAgentsRedactedBlock object { type }`
615 - `BetaManagedAgentsRedactedBlock object`
631616
632617 Placeholder for content withheld by Anthropic model policy.
633618
634619 - `type: "redacted"`
635620
636 - `"redacted"`
637
638621 - `type: "user.message"`
639622
640 - `"user.message"`
641
642623 - `processed_at: optional string or null`
643624
644625 A timestamp in RFC 3339 format
645626
646 - `BetaManagedAgentsUserInterruptEvent object { id, type, processed_at, session_thread_id }`
627 format: date-time
647628
629 - `BetaManagedAgentsUserInterruptEvent object`
630
648631 An interrupt event that pauses agent execution and returns control to the user.
649632
650633 - `id: string`
from line 636
653636
654637 - `type: "user.interrupt"`
655638
656 - `"user.interrupt"`
657
658639 - `processed_at: optional string or null`
659640
660641 A timestamp in RFC 3339 format
661642
643 format: date-time
644
662645 - `session_thread_id: optional string or null`
663646
664647 If absent, interrupts every non-archived thread in a multiagent session (or the primary alone in a single-agent session). If present, interrupts only the named thread.
665648
666 - `BetaManagedAgentsUserToolConfirmationEvent object { id, result, tool_use_id, 4 more }`
649 - `BetaManagedAgentsUserToolConfirmationEvent object`
667650
668651 A tool confirmation event that approves or denies a pending tool execution.
669652
from line 668
685668
686669 - `type: "user.tool_confirmation"`
687670
688 - `"user.tool_confirmation"`
689
690671 - `deny_message: optional string or null`
691672
692673 Optional message providing context for a 'deny' decision. Only allowed when result is 'deny'.
693674
675 maxLength: 10000
676
694677 - `processed_at: optional string or null`
695678
696679 A timestamp in RFC 3339 format
697680
681 format: date-time
682
698683 - `session_thread_id: optional string or null`
699684
700685 When set, the confirmation routes to this subagent's thread rather than the primary. Echo this from the `session_thread_id` on the `agent.tool_use` or `agent.mcp_tool_use` event that prompted the approval.
701686
702 - `BetaManagedAgentsUserCustomToolResultEvent object { id, custom_tool_use_id, type, 4 more }`
687 - `BetaManagedAgentsUserCustomToolResultEvent object`
703688
704689 Event sent by the client providing the result of a custom tool execution.
705690
from line 698
713698
714699 - `type: "user.custom_tool_result"`
715700
716 - `"user.custom_tool_result"`
717
718701 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
719702
720703 The result content returned by the tool.
721704
722 - `BetaManagedAgentsTextBlock object { text, type }`
705 - `BetaManagedAgentsTextBlock object`
723706
724707 Regular text content.
725708
726 - `BetaManagedAgentsImageBlock object { source, type }`
709 - `BetaManagedAgentsImageBlock object`
727710
728711 Image content specified directly as base64 data or as a reference via a URL.
729712
730 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
713 - `BetaManagedAgentsDocumentBlock object`
731714
732715 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
733716
734 - `BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }`
717 - `BetaManagedAgentsSearchResultBlock object`
735718
736719 A block containing a web search result.
737720
from line 734
751734
752735 The text content.
753736
737 minLength: 1
738
754739 - `type: "text"`
755740
756 - `"text"`
757
758741 - `source: string`
759742
760743 The URL source of the search result.
761744
745 minLength: 1
746
762747 - `title: string`
763748
764749 The title of the search result.
765750
751 minLength: 1
752
766753 - `type: "search_result"`
767754
768 - `"search_result"`
769
770755 - `is_error: optional boolean or null`
771756
772757 Whether the tool execution resulted in an error.
from line 760
775760
776761 A timestamp in RFC 3339 format
777762
763 format: date-time
764
778765 - `session_thread_id: optional string or null`
779766
780767 Routes this result to a subagent thread. Copy from the `agent.custom_tool_use` event's `session_thread_id`.
781768
782 - `BetaManagedAgentsUserDefineOutcomeEvent object { id, description, max_iterations, 4 more }`
769 - `BetaManagedAgentsUserDefineOutcomeEvent object`
783770
784771 Echo of a `user.define_outcome` input event. Carries the server-generated `outcome_id` that subsequent `span.outcome_evaluation_*` events reference.
785772
from line 782
795782
796783 Evaluate-then-revise cycles before giving up. Default 3, max 20.
797784
785 format: int32
786
798787 - `outcome_id: string`
799788
800789 Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list.
from line 792
803792
804793 A timestamp in RFC 3339 format
805794
795 format: date-time
796
806797 - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`
807798
808799 Rubric for grading the quality of an outcome.
809800
810 - `BetaManagedAgentsFileRubric object { file_id, type }`
801 - `BetaManagedAgentsFileRubric object`
811802
812803 Rubric referenced by a file uploaded via the Files API.
813804
from line 808
817808
818809 - `type: "file"`
819810
820 - `"file"`
811 - `BetaManagedAgentsTextRubric object`
821812
822 - `BetaManagedAgentsTextRubric object { content, type }`
823
824813 Rubric content provided inline as text.
825814
826815 - `content: string`
from line 818
829818
830819 - `type: "text"`
831820
832 - `"text"`
833
834821 - `type: "user.define_outcome"`
835822
836 - `"user.define_outcome"`
823 - `BetaManagedAgentsUserToolResultEvent object`
837824
838 - `BetaManagedAgentsUserToolResultEvent object { id, tool_use_id, type, 4 more }`
839
840825 Event sent by the client providing the result of an agent-toolset tool execution. Only valid on `self_hosted` environments, where sandbox-routed tools are executed by the client rather than the server.
841826
842827 - `id: string`
from line 834
849834
850835 - `type: "user.tool_result"`
851836
852 - `"user.tool_result"`
853
854837 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
855838
856839 The result content returned by the tool.
857840
858 - `BetaManagedAgentsTextBlock object { text, type }`
841 - `BetaManagedAgentsTextBlock object`
859842
860843 Regular text content.
861844
862 - `BetaManagedAgentsImageBlock object { source, type }`
845 - `BetaManagedAgentsImageBlock object`
863846
864847 Image content specified directly as base64 data or as a reference via a URL.
865848
866 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
849 - `BetaManagedAgentsDocumentBlock object`
867850
868851 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
869852
870 - `BetaManagedAgentsSearchResultBlock object { citations, content, source, 2 more }`
853 - `BetaManagedAgentsSearchResultBlock object`
871854
872855 A block containing a web search result.
873856
from line 862
879862
880863 A timestamp in RFC 3339 format
881864
865 format: date-time
866
882867 - `session_thread_id: optional string or null`
883868
884869 Routes this result to a subagent thread. Copy from the `agent.tool_use` event's `session_thread_id`.
885870
886 - `BetaManagedAgentsSystemMessageEvent object { id, content, type, processed_at }`
871 - `BetaManagedAgentsSystemMessageEvent object`
887872
888873 A mid-conversation system message event. Carries system-role content that is appended to the session as a `role: "system"` turn.
889874
from line 884
899884
900885 The text content.
901886
887 minLength: 1
888
902889 - `type: "text"`
903890
904 - `"text"`
905
906891 - `type: "system.message"`
907892
908 - `"system.message"`
909
910893 - `processed_at: optional string or null`
911894
912895 A timestamp in RFC 3339 format
913896
914### Example
897 format: date-time
915898
916```http
899## Example
900
901```bash
917902curl https://api.anthropic.com/v1/sessions/$SESSION_ID/events \
918903 -H 'Content-Type: application/json' \
919904 -H 'anthropic-version: 2023-06-01' \
from line 919
934919 }'
935920```
936921
937#### Response
922### Response (200)
938923
939924```json
940925{
No line in this hunk matches that.