Stream Session Thread Events changedapi/beta/sessions/threads/events/stream
Nearest release: v2.1.283, published 3 hours 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+73added
Lines−75removed
From line
177
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits14to this page, all time
The whole hunk
from line 177, old and new numbered
/
from line 177
177177
178178 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
179179
180 Union type for image source variants.
180 The source of the image data.
181181
182182 - `BetaManagedAgentsBase64ImageSource object`
183183
from line 229
229229
230230 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
231231
232 Union type for document source variants.
232 The source of the document data.
233233
234234 - `BetaManagedAgentsBase64DocumentSource object`
235235
from line 305
305305
306306 - `processed_at: optional string or null`
307307
308 A timestamp in RFC 3339 format
308 Timestamp when the agent finished processing this message.
309309
310310 format: date-time
311311
from line 321
321321
322322 - `processed_at: optional string or null`
323323
324 A timestamp in RFC 3339 format
324 Timestamp when the interrupt was processed.
325325
326326 format: date-time
327327
from line 341
341341
342342 - `result: "allow" or "deny"`
343343
344 UserToolConfirmationResult enum
344 The confirmation result: 'allow' or 'deny'.
345345
346346 - `"allow"`
347347
from line 359
359359
360360 - `processed_at: optional string or null`
361361
362 A timestamp in RFC 3339 format
362 Timestamp when the confirmation was processed.
363363
364364 format: date-time
365365
from line 405
405405
406406 - `citations: BetaManagedAgentsSearchResultCitations`
407407
408 Citation settings for a search result.
408 Citation settings for this search result.
409409
410410 - `enabled: boolean`
411411
from line 441
441441
442442 - `processed_at: optional string or null`
443443
444 A timestamp in RFC 3339 format
444 Timestamp when this result was processed.
445445
446446 format: date-time
447447
from line 469
469469
470470 - `processed_at: string`
471471
472 A timestamp in RFC 3339 format
472 Timestamp when this tool use was processed.
473473
474474 format: date-time
475475
from line 501
501501
502502 - `processed_at: string`
503503
504 A timestamp in RFC 3339 format
504 Timestamp when this response was generated.
505505
506506 format: date-time
507507
from line 517
517517
518518 - `processed_at: string`
519519
520 A timestamp in RFC 3339 format
520 Timestamp when this thinking was produced.
521521
522522 format: date-time
523523
from line 545
545545
546546 - `processed_at: string`
547547
548 A timestamp in RFC 3339 format
548 Timestamp when this event was processed.
549549
550550 format: date-time
551551
552552 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
553553
554 AgentEvaluatedPermission enum
554 The evaluated permission policy for this tool invocation.
555555
556556 - `"allow"`
557557
from line 561
561561
562562 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
563563
564 Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
564 Which resolved permission_policy produced evaluated_permission: always_allow, always_ask, or auto (with the server's per-invocation judgement). Absent only when the server refused the call before any policy applied (for example, the named tool is not enabled in the session); such a refusal has evaluated_permission deny. An event recorded before this field existed reads as the arm its evaluated_permission implies (always_allow for allow, always_ask for ask).
565565
566566 - `BetaManagedAgentsAgentToolEvaluationAlwaysAllow object`
567567
from line 583
583583
584584 - `evaluated_permission: BetaManagedAgentsAgentAutoEvaluatedPermission`
585585
586 The server's per-invocation judgement under the auto permission policy. Its type always equals the event's top-level evaluated_permission. Open union: clients must tolerate unknown variants.
586 The server's judgement for this invocation.
587587
588588 - `BetaManagedAgentsAgentAutoEvaluatedPermissionAllow object`
589589
from line 635
635635
636636 - `processed_at: string`
637637
638 A timestamp in RFC 3339 format
638 Timestamp when this event was processed.
639639
640640 format: date-time
641641
from line 683
683683
684684 - `processed_at: string`
685685
686 A timestamp in RFC 3339 format
686 Timestamp when this event was processed.
687687
688688 format: date-time
689689
690690 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
691691
692 AgentEvaluatedPermission enum
692 The evaluated permission policy for this tool invocation.
693693
694694 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
695695
696 Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
696 Which resolved permission_policy produced evaluated_permission: always_allow, always_ask, or auto (with the server's per-invocation judgement). Absent only when the server refused the call before any policy applied (for example, the named tool is not enabled in the session); such a refusal has evaluated_permission deny. An event recorded before this field existed reads as the arm its evaluated_permission implies (always_allow for allow, always_ask for ask).
697697
698698 - `session_thread_id: optional string or null`
699699
from line 711
711711
712712 - `processed_at: string`
713713
714 A timestamp in RFC 3339 format
714 Timestamp when this event was processed.
715715
716716 format: date-time
717717
from line 779
779779
780780 - `processed_at: string`
781781
782 A timestamp in RFC 3339 format
782 Timestamp when the message was received.
783783
784784 format: date-time
785785
from line 819
819819
820820 - `processed_at: string`
821821
822 A timestamp in RFC 3339 format
822 Timestamp when the message was sent.
823823
824824 format: date-time
825825
from line 843
843843
844844 - `processed_at: string`
845845
846 A timestamp in RFC 3339 format
846 Timestamp when compaction was processed.
847847
848848 format: date-time
849849
from line 871
871871
872872 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
873873
874 What the client should do next in response to this error.
874 What the client should do next.
875875
876876 - `BetaManagedAgentsRetryStatusRetrying object`
877877
from line 903
903903
904904 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
905905
906 What the client should do next in response to this error.
906 What the client should do next.
907907
908908 - `BetaManagedAgentsRetryStatusRetrying object`
909909
from line 929
929929
930930 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
931931
932 What the client should do next in response to this error.
932 What the client should do next.
933933
934934 - `BetaManagedAgentsRetryStatusRetrying object`
935935
from line 955
955955
956956 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
957957
958 What the client should do next in response to this error.
958 What the client should do next.
959959
960960 - `BetaManagedAgentsRetryStatusRetrying object`
961961
from line 985
985985
986986 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
987987
988 What the client should do next in response to this error.
988 What the client should do next.
989989
990990 - `BetaManagedAgentsRetryStatusRetrying object`
991991
from line 1015
10151015
10161016 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
10171017
1018 What the client should do next in response to this error.
1018 What the client should do next.
10191019
10201020 - `BetaManagedAgentsRetryStatusRetrying object`
10211021
from line 1041
10411041
10421042 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
10431043
1044 What the client should do next in response to this error.
1044 What the client should do next.
10451045
10461046 - `BetaManagedAgentsRetryStatusRetrying object`
10471047
from line 1071
10711071
10721072 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
10731073
1074 What the client should do next in response to this error.
1074 What the client should do next.
10751075
10761076 - `BetaManagedAgentsRetryStatusRetrying object`
10771077
from line 1091
10911091
10921092 - `processed_at: string`
10931093
1094 A timestamp in RFC 3339 format
1094 Timestamp when the error occurred.
10951095
10961096 format: date-time
10971097
from line 1107
11071107
11081108 - `processed_at: string`
11091109
1110 A timestamp in RFC 3339 format
1110 Timestamp of status change.
11111111
11121112 format: date-time
11131113
from line 1123
11231123
11241124 - `processed_at: string`
11251125
1126 A timestamp in RFC 3339 format
1126 Timestamp of status change.
11271127
11281128 format: date-time
11291129
from line 1139
11391139
11401140 - `processed_at: string`
11411141
1142 A timestamp in RFC 3339 format
1142 Timestamp of status change.
11431143
11441144 format: date-time
11451145
from line 1185
11851185
11861186 - `processed_at: string`
11871187
1188 A timestamp in RFC 3339 format
1188 Timestamp of status change.
11891189
11901190 format: date-time
11911191
from line 1205
12051205
12061206 - `processed_at: string`
12071207
1208 A timestamp in RFC 3339 format
1208 Timestamp when the thread was created.
12091209
12101210 format: date-time
12111211
from line 1235
12351235
12361236 - `processed_at: string`
12371237
1238 A timestamp in RFC 3339 format
1238 Timestamp when outcome evaluation started.
12391239
12401240 format: date-time
12411241
from line 1269
12691269
12701270 - `processed_at: string`
12711271
1272 A timestamp in RFC 3339 format
1272 Timestamp when outcome evaluation ended.
12731273
12741274 format: date-time
12751275
from line 1279
12791279
12801280 - `usage: BetaManagedAgentsSpanModelUsage`
12811281
1282 Token usage for a single model request.
1282 Aggregate token usage for this evaluation cycle. Sums across all grader model requests within the cycle.
12831283
12841284 - `cache_creation_input_tokens: number`
12851285
from line 1307
13071307
13081308 - `speed: optional "standard" or "fast" or null`
13091309
1310 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
1310 Inference speed tier this request actually ran at. Mirrors `usage.speed` on /v1/messages. Only present when the fast-mode beta is active.
13111311
13121312 - `"standard"`
13131313
from line 1325
13251325
13261326 - `processed_at: string`
13271327
1328 A timestamp in RFC 3339 format
1328 Timestamp when the model request started.
13291329
13301330 format: date-time
13311331
from line 1349
13491349
13501350 - `model_usage: BetaManagedAgentsSpanModelUsage`
13511351
1352 Token usage for a single model request.
1352 Token usage for this model request.
13531353
13541354 - `processed_at: string`
13551355
1356 A timestamp in RFC 3339 format
1356 Timestamp when the model request completed.
13571357
13581358 format: date-time
13591359
from line 1379
13791379
13801380 - `processed_at: string`
13811381
1382 A timestamp in RFC 3339 format
1382 Timestamp when this heartbeat was emitted.
13831383
13841384 format: date-time
13851385
from line 1409
14091409
14101410 - `processed_at: string`
14111411
1412 A timestamp in RFC 3339 format
1412 Timestamp when the outcome was accepted.
14131413
14141414 format: date-time
14151415
14161416 - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`
14171417
1418 Rubric for grading the quality of an outcome.
1418 How to grade the outcome. File rubrics are currently resolved to their text content; clients should handle both variants.
14191419
14201420 - `BetaManagedAgentsFileRubric object`
14211421
from line 1449
14491449
14501450 - `processed_at: string`
14511451
1452 A timestamp in RFC 3339 format
1452 Timestamp when the session was deleted.
14531453
14541454 format: date-time
14551455
from line 1469
14691469
14701470 - `processed_at: string`
14711471
1472 A timestamp in RFC 3339 format
1472 Timestamp of the status transition.
14731473
14741474 format: date-time
14751475
from line 1493
14931493
14941494 - `processed_at: string`
14951495
1496 A timestamp in RFC 3339 format
1496 Timestamp of the status transition.
14971497
14981498 format: date-time
14991499
from line 1535
15351535
15361536 - `processed_at: string`
15371537
1538 A timestamp in RFC 3339 format
1538 Timestamp of the status transition.
15391539
15401540 format: date-time
15411541
from line 1583
15831583
15841584 - `processed_at: optional string or null`
15851585
1586 A timestamp in RFC 3339 format
1586 Timestamp when this result was processed.
15871587
15881588 format: date-time
15891589
from line 1607
16071607
16081608 - `processed_at: string`
16091609
1610 A timestamp in RFC 3339 format
1610 Timestamp of the status transition.
16111611
16121612 format: date-time
16131613
from line 1627
16271627
16281628 - `processed_at: string`
16291629
1630 A timestamp in RFC 3339 format
1630 Timestamp when the update was applied.
16311631
16321632 format: date-time
16331633
16341634 - `agent: optional BetaManagedAgentsSessionAgent or null`
16351635
1636 Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
1636 The session's effective agent configuration after the update. Present only when the update changed `agent` (tools or mcp_servers); when present it is the full materialised snapshot, not a diff.
16371637
16381638 - `type: "agent"`
16391639
from line 1659
16591659
16601660 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
16611661
1662 - `string`
1663
16621664 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
16631665
16641666 The model that will power your agent.
from line 1727
17251727
17261728 High-performance model for agents and coding
17271729
1728 - `string`
1729
17301730 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
17311731
1732 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
1732 How hard Claude works on each inference call. One of `low`, `medium`, `high`, `xhigh`, `max`. Always present; resolved to the per-model default at save time when not supplied.
17331733
17341734 - `BetaManagedAgentsEffortLow object`
17351735
from line 1767
17671767
17681768 - `speed: optional "standard" or "fast"`
17691769
1770 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Not all models support `fast`; invalid combinations are rejected at create time.
1770 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Defaults to `standard`. Not all models support `fast`; invalid combinations are rejected at create time.
17711771
17721772 - `"standard"`
17731773
from line 1775
17751775
17761776 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
17771777
1778 Resolved coordinator topology with full agent definitions for each roster member.
1778 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
17791779
17801780 - `type: "coordinator"`
17811781
from line 2231
22312231
22322232 - `budget: optional BetaManagedAgentsBudgetLimit or null`
22332233
2234 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
2234 The session's budget after the update: the new budget when set or replaced, or null when the update removed it. Present only when the update changed the budget.
22352235
22362236 - `type: "limit"`
22372237
22382238 - `max_list_cost: BetaMonetaryAmount`
22392239
2240 A monetary amount in a specific currency.
2240 Maximum list cost the session may accrue. List price is used regardless of any negotiated discount, so the cap fires at or before the actual charge.
22412241
22422242 - `amount: string`
22432243
from line 2295
22952295
22962296 - `content: BetaManagedAgentsTextBlock`
22972297
2298 Regular text content.
2298 A partial element of the content array at index, typed like the element itself — the same shape the buffered agent.message carries in content.
22992299
23002300 - `index: optional number`
23012301
23022302 Which entry in the previewed event's content array this fragment lands in. Insert content as that entry when the index is new; append to the existing entry otherwise.
23032303
2304 format: uint32
2305
23062304 - `event_id: string`
23072305
23082306 The id of the event being previewed. Matches event.id on the corresponding event_start and the buffered event that reconciles the preview.
from line 2329
23312329
23322330 - `processed_at: optional string or null`
23332331
2334 A timestamp in RFC 3339 format
2332 Timestamp when this system message was processed.
23352333
23362334 format: date-time
23372335
from line 2345
23472345
23482346 - `processed_at: string`
23492347
2350 A timestamp in RFC 3339 format
2348 Timestamp when the snapshot was taken.
23512349
23522350 format: date-time
23532351
23542352 - `usage: BetaManagedAgentsSessionUsageSnapshot`
23552353
2356 Point-in-time snapshot of a session's cumulative usage.
2354 The session's cumulative usage at the snapshot time.
23572355
23582356 - `active_seconds: optional number`
23592357
from line 2361
23632361
23642362 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
23652363
2366 Prompt-cache creation token usage broken down by cache lifetime.
2364 Tokens used to create prompt cache entries, broken down by cache TTL.
23672365
23682366 - `ephemeral_1h_input_tokens: optional number`
23692367
from line 2389
23912389
23922390 - `list_cost: optional BetaMonetaryAmount`
23932391
2394 A monetary amount in a specific currency.
2392 Cumulative list cost of the session across all turns, priced at public list rates.
23952393
23962394 - `output_tokens: optional number`
23972395
from line 2399
24012399
24022400 - `server_tool_use: optional BetaManagedAgentsServerToolUsage`
24032401
2404 Cumulative count of server-executed tool invocations, broken down by tool.
2402 Cumulative server-executed tool usage across all turns.
24052403
24062404 - `web_fetch_requests: optional number`
24072405
from line 2415
24172415
24182416 - `budget: optional BetaManagedAgentsBudgetLimit or null`
24192417
2420 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
2418 The session's configured budget at the snapshot time, or null when the session has no budget.
24212419
24222420## Example
24232421
No line in this hunk matches that.