One read of Claude Developer Platformapi-20260925T153714Z
310 pages moved out of 637 read.
Pages moved
310
significant first
Pages read
637
in this capture
Captured
15:37 UTC
Corpus hash
850f99a0d461
corpus-hash
What this read moved
76-100 of 310, page 4 of 13This capture is too large to show at once. Changes 76-100 of 310 are below, significant first; the rest are on the following screens.
api/beta/sessions/list Changed · +250 / -250 lines
from line 245
245245
246246 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
247247
248 - `string`
249
248250 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
249251
250252 The model that will power your agent.
from line 313
311313
312314 High-performance model for agents and coding
313315
314 - `string`
315
316316 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
317317
318 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
318 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.
319319
320320 - `BetaManagedAgentsEffortLow object`
321321
from line 353
353353
354354 - `speed: optional "standard" or "fast"`
355355
356 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.
356 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.
357357
358358 - `"standard"`
359359
from line 361
361361
362362 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
363363
364 Resolved coordinator topology with full agent definitions for each roster member.
364 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
365365
366366 - `type: "coordinator"`
367367
from line 817
817817
818818 - `archived_at: string or null`
819819
820 A timestamp in RFC 3339 format
820 When the session was archived. Null if not archived.
821821
822822 format: date-time
823823
824824 - `budget: BetaManagedAgentsBudgetLimit or null`
825825
826 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
826 The session's enforced spend ceiling, or null when no budget is set.
827827
828828 - `type: "limit"`
829829
830830 - `max_list_cost: BetaMonetaryAmount`
831831
832 A monetary amount in a specific currency.
832 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.
833833
834834 - `amount: string`
835835
from line 857
857857
858858 - `completed_at: string or null`
859859
860 A timestamp in RFC 3339 format
860 When the outcome reached a terminal result. Null while `pending`/`running`/`evaluating`.
861861
862862 format: date-time
863863
from line 963
963963
964964 - `access: optional "read_write" or "read_only" or null`
965965
966 Access mode for an attached memory store.
966 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
967967
968968 - `"read_write"`
969969
from line 989
989989
990990 - `stats: BetaManagedAgentsSessionStats`
991991
992 Timing statistics for a session.
992 Timing statistics for the session.
993993
994994 - `active_seconds: optional number`
995995
from line 1033
10331033
10341034 - `usage: BetaManagedAgentsSessionUsage`
10351035
1036 Cumulative token usage for a session across all turns.
1036 Cumulative token usage for the session.
10371037
10381038 - `active_seconds: optional number`
10391039
from line 1043
10431043
10441044 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
10451045
1046 Prompt-cache creation token usage broken down by cache lifetime.
1046 Tokens used to create prompt cache entries, broken down by cache TTL.
10471047
10481048 - `ephemeral_1h_input_tokens: optional number`
10491049
from line 1071
10711071
10721072 - `list_cost: optional BetaMonetaryAmount or null`
10731073
1074 A monetary amount in a specific currency.
1074 Cumulative list cost of the session across all turns, priced at public list rates. Absent until cost tracking is available for the session.
10751075
10761076 - `output_tokens: optional number`
10771077
from line 1081
10811081
10821082 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
10831083
1084 Cumulative count of server-executed tool invocations, broken down by tool.
1084 Cumulative server-executed tool usage across all turns. Absent until server-tool tracking is available for the session.
10851085
10861086 - `web_fetch_requests: optional number`
10871087
api/beta/sessions/resources Changed · +7 / -7 lines
from line 413
413413
414414 - `access: optional "read_write" or "read_only" or null`
415415
416 Access mode for an attached memory store.
416 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
417417
418418 - `"read_write"`
419419
from line 684
684684
685685 - `access: optional "read_write" or "read_only" or null`
686686
687 Access mode for an attached memory store.
687 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
688688
689689 - `"read_write"`
690690
from line 946
946946
947947 - `access: optional "read_write" or "read_only" or null`
948948
949 Access mode for an attached memory store.
949 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
950950
951951 - `"read_write"`
952952
from line 1249
12491249
12501250 - `access: optional "read_write" or "read_only" or null`
12511251
1252 Access mode for an attached memory store.
1252 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
12531253
12541254 - `"read_write"`
12551255
from line 1355
13551355
13561356 - `access: optional "read_write" or "read_only" or null`
13571357
1358 Access mode for an attached memory store.
1358 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
13591359
13601360 - `"read_write"`
13611361
from line 1463
14631463
14641464 - `access: optional "read_write" or "read_only" or null`
14651465
1466 Access mode for an attached memory store.
1466 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
14671467
14681468 - `"read_write"`
14691469
from line 1571
15711571
15721572 - `access: optional "read_write" or "read_only" or null`
15731573
1574 Access mode for an attached memory store.
1574 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
15751575
15761576 - `"read_write"`
15771577
api/beta/sessions/retrieve Changed · +250 / -250 lines
from line 163
163163
164164 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
165165
166 - `string`
167
166168 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
167169
168170 The model that will power your agent.
from line 231
229231
230232 High-performance model for agents and coding
231233
232 - `string`
233
234234 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
235235
236 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
236 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.
237237
238238 - `BetaManagedAgentsEffortLow object`
239239
from line 271
271271
272272 - `speed: optional "standard" or "fast"`
273273
274 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.
274 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.
275275
276276 - `"standard"`
277277
from line 279
279279
280280 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
281281
282 Resolved coordinator topology with full agent definitions for each roster member.
282 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
283283
284284 - `type: "coordinator"`
285285
from line 735
735735
736736 - `archived_at: string or null`
737737
738 A timestamp in RFC 3339 format
738 When the session was archived. Null if not archived.
739739
740740 format: date-time
741741
742742 - `budget: BetaManagedAgentsBudgetLimit or null`
743743
744 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
744 The session's enforced spend ceiling, or null when no budget is set.
745745
746746 - `type: "limit"`
747747
748748 - `max_list_cost: BetaMonetaryAmount`
749749
750 A monetary amount in a specific currency.
750 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.
751751
752752 - `amount: string`
753753
from line 775
775775
776776 - `completed_at: string or null`
777777
778 A timestamp in RFC 3339 format
778 When the outcome reached a terminal result. Null while `pending`/`running`/`evaluating`.
779779
780780 format: date-time
781781
from line 881
881881
882882 - `access: optional "read_write" or "read_only" or null`
883883
884 Access mode for an attached memory store.
884 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
885885
886886 - `"read_write"`
887887
from line 907
907907
908908 - `stats: BetaManagedAgentsSessionStats`
909909
910 Timing statistics for a session.
910 Timing statistics for the session.
911911
912912 - `active_seconds: optional number`
913913
from line 951
951951
952952 - `usage: BetaManagedAgentsSessionUsage`
953953
954 Cumulative token usage for a session across all turns.
954 Cumulative token usage for the session.
955955
956956 - `active_seconds: optional number`
957957
from line 961
961961
962962 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
963963
964 Prompt-cache creation token usage broken down by cache lifetime.
964 Tokens used to create prompt cache entries, broken down by cache TTL.
965965
966966 - `ephemeral_1h_input_tokens: optional number`
967967
from line 989
989989
990990 - `list_cost: optional BetaMonetaryAmount or null`
991991
992 A monetary amount in a specific currency.
992 Cumulative list cost of the session across all turns, priced at public list rates. Absent until cost tracking is available for the session.
993993
994994 - `output_tokens: optional number`
995995
from line 999
999999
10001000 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
10011001
1002 Cumulative count of server-executed tool invocations, broken down by tool.
1002 Cumulative server-executed tool usage across all turns. Absent until server-tool tracking is available for the session.
10031003
10041004 - `web_fetch_requests: optional number`
10051005
api/beta/sessions/threads Changed · +5354 / -5358 lines
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
Nothing in the body moved in this read. What changed is above.
api/beta/sessions/threads/archive Changed · +14 / -14 lines
from line 141
141141
142142 - `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
143143
144 The resolved agent a `session_thread` runs.
144 Resolved agent definition for this thread. Snapshot of the agent at thread creation time.
145145
146146 - `BetaManagedAgentsSessionThreadAgent object`
147147
from line 171
171171
172172 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
173173
174 - `string`
175
174176 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
175177
176178 The model that will power your agent.
from line 239
237239
238240 High-performance model for agents and coding
239241
240 - `string`
241
242242 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
243243
244 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
244 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.
245245
246246 - `BetaManagedAgentsEffortLow object`
247247
from line 279
279279
280280 - `speed: optional "standard" or "fast"`
281281
282 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.
282 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.
283283
284284 - `"standard"`
285285
from line 683
683683
684684 - `archived_at: string or null`
685685
686 A timestamp in RFC 3339 format
686 When the thread was archived. Null if not archived.
687687
688688 format: date-time
689689
690690 - `created_at: string`
691691
692 A timestamp in RFC 3339 format
692 When the thread was created.
693693
694694 format: date-time
695695
from line 703
703703
704704 - `stats: BetaManagedAgentsSessionThreadStats or null`
705705
706 Timing statistics for a session thread.
706 Timing statistics for this thread. Null until the thread's first status transition.
707707
708708 - `active_seconds: optional number`
709709
from line 725
725725
726726 - `status: BetaManagedAgentsSessionThreadStatus`
727727
728 SessionThreadStatus enum
728 Current execution status of the thread.
729729
730730 - `"running"`
731731
from line 737
737737
738738 - `updated_at: string`
739739
740 A timestamp in RFC 3339 format
740 When the thread was last updated.
741741
742742 format: date-time
743743
744744 - `usage: BetaManagedAgentsSessionThreadUsage or null`
745745
746 Cumulative token usage for a session thread across all turns.
746 Cumulative token usage for this thread. Null until the thread's first idle transition.
747747
748748 - `active_seconds: optional number`
749749
from line 753
753753
754754 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
755755
756 Prompt-cache creation token usage broken down by cache lifetime.
756 Tokens used to create prompt cache entries, broken down by cache TTL.
757757
758758 - `ephemeral_1h_input_tokens: optional number`
759759
from line 781
781781
782782 - `list_cost: optional BetaMonetaryAmount or null`
783783
784 A monetary amount in a specific currency.
784 Cumulative list cost of this thread across all turns, priced at public list rates. Absent until cost tracking is available for the thread. Each figure is rounded to the nearest cent independently and the session's aggregate `usage.list_cost` additionally includes session runtime, so per-thread costs do not sum exactly to the session figure; the session figure is authoritative and is what a budget is enforced against.
785785
786786 - `amount: string`
787787
from line 799
799799
800800 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
801801
802 Cumulative count of server-executed tool invocations, broken down by tool.
802 Cumulative server-executed tool usage across all turns of this thread. Absent until server-tool tracking is available for the thread.
803803
804804 - `web_fetch_requests: optional number`
805805
api/beta/sessions/threads/events Changed · +145 / -147 lines
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 2279
22792279
22802280 - `processed_at: optional string or null`
22812281
2282 A timestamp in RFC 3339 format
2282 Timestamp when this system message was processed.
22832283
22842284 format: date-time
22852285
from line 2295
22952295
22962296 - `processed_at: string`
22972297
2298 A timestamp in RFC 3339 format
2298 Timestamp when the snapshot was taken.
22992299
23002300 format: date-time
23012301
23022302 - `usage: BetaManagedAgentsSessionUsageSnapshot`
23032303
2304 Point-in-time snapshot of a session's cumulative usage.
2304 The session's cumulative usage at the snapshot time.
23052305
23062306 - `active_seconds: optional number`
23072307
from line 2311
23112311
23122312 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
23132313
2314 Prompt-cache creation token usage broken down by cache lifetime.
2314 Tokens used to create prompt cache entries, broken down by cache TTL.
23152315
23162316 - `ephemeral_1h_input_tokens: optional number`
23172317
from line 2339
23392339
23402340 - `list_cost: optional BetaMonetaryAmount`
23412341
2342 A monetary amount in a specific currency.
2342 Cumulative list cost of the session across all turns, priced at public list rates.
23432343
23442344 - `output_tokens: optional number`
23452345
from line 2349
23492349
23502350 - `server_tool_use: optional BetaManagedAgentsServerToolUsage`
23512351
2352 Cumulative count of server-executed tool invocations, broken down by tool.
2352 Cumulative server-executed tool usage across all turns.
23532353
23542354 - `web_fetch_requests: optional number`
23552355
from line 2365
23652365
23662366 - `budget: optional BetaManagedAgentsBudgetLimit or null`
23672367
2368 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
2368 The session's configured budget at the snapshot time, or null when the session has no budget.
23692369
23702370- `next_page: optional string or null`
23712371
from line 2575
25752575
25762576 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
25772577
2578 Union type for image source variants.
2578 The source of the image data.
25792579
25802580 - `BetaManagedAgentsBase64ImageSource object`
25812581
from line 2627
26272627
26282628 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
26292629
2630 Union type for document source variants.
2630 The source of the document data.
26312631
26322632 - `BetaManagedAgentsBase64DocumentSource object`
26332633
from line 2703
27032703
27042704 - `processed_at: optional string or null`
27052705
2706 A timestamp in RFC 3339 format
2706 Timestamp when the agent finished processing this message.
27072707
27082708 format: date-time
27092709
from line 2719
27192719
27202720 - `processed_at: optional string or null`
27212721
2722 A timestamp in RFC 3339 format
2722 Timestamp when the interrupt was processed.
27232723
27242724 format: date-time
27252725
from line 2739
27392739
27402740 - `result: "allow" or "deny"`
27412741
2742 UserToolConfirmationResult enum
2742 The confirmation result: 'allow' or 'deny'.
27432743
27442744 - `"allow"`
27452745
from line 2757
27572757
27582758 - `processed_at: optional string or null`
27592759
2760 A timestamp in RFC 3339 format
2760 Timestamp when the confirmation was processed.
27612761
27622762 format: date-time
27632763
from line 2803
28032803
28042804 - `citations: BetaManagedAgentsSearchResultCitations`
28052805
2806 Citation settings for a search result.
2806 Citation settings for this search result.
28072807
28082808 - `enabled: boolean`
28092809
from line 2839
28392839
28402840 - `processed_at: optional string or null`
28412841
2842 A timestamp in RFC 3339 format
2842 Timestamp when this result was processed.
28432843
28442844 format: date-time
28452845
from line 2867
28672867
28682868 - `processed_at: string`
28692869
2870 A timestamp in RFC 3339 format
2870 Timestamp when this tool use was processed.
28712871
28722872 format: date-time
28732873
from line 2899
28992899
29002900 - `processed_at: string`
29012901
2902 A timestamp in RFC 3339 format
2902 Timestamp when this response was generated.
29032903
29042904 format: date-time
29052905
from line 2915
29152915
29162916 - `processed_at: string`
29172917
2918 A timestamp in RFC 3339 format
2918 Timestamp when this thinking was produced.
29192919
29202920 format: date-time
29212921
from line 2943
29432943
29442944 - `processed_at: string`
29452945
2946 A timestamp in RFC 3339 format
2946 Timestamp when this event was processed.
29472947
29482948 format: date-time
29492949
29502950 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
29512951
2952 AgentEvaluatedPermission enum
2952 The evaluated permission policy for this tool invocation.
29532953
29542954 - `"allow"`
29552955
from line 2959
29592959
29602960 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
29612961
2962 Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
2962 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).
29632963
29642964 - `BetaManagedAgentsAgentToolEvaluationAlwaysAllow object`
29652965
from line 2981
29812981
29822982 - `evaluated_permission: BetaManagedAgentsAgentAutoEvaluatedPermission`
29832983
2984 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.
2984 The server's judgement for this invocation.
29852985
29862986 - `BetaManagedAgentsAgentAutoEvaluatedPermissionAllow object`
29872987
from line 3033
30333033
30343034 - `processed_at: string`
30353035
3036 A timestamp in RFC 3339 format
3036 Timestamp when this event was processed.
30373037
30383038 format: date-time
30393039
from line 3081
30813081
30823082 - `processed_at: string`
30833083
3084 A timestamp in RFC 3339 format
3084 Timestamp when this event was processed.
30853085
30863086 format: date-time
30873087
30883088 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
30893089
3090 AgentEvaluatedPermission enum
3090 The evaluated permission policy for this tool invocation.
30913091
30923092 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
30933093
3094 Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
3094 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).
30953095
30963096 - `session_thread_id: optional string or null`
30973097
from line 3109
31093109
31103110 - `processed_at: string`
31113111
3112 A timestamp in RFC 3339 format
3112 Timestamp when this event was processed.
31133113
31143114 format: date-time
31153115
from line 3177
31773177
31783178 - `processed_at: string`
31793179
3180 A timestamp in RFC 3339 format
3180 Timestamp when the message was received.
31813181
31823182 format: date-time
31833183
from line 3217
32173217
32183218 - `processed_at: string`
32193219
3220 A timestamp in RFC 3339 format
3220 Timestamp when the message was sent.
32213221
32223222 format: date-time
32233223
from line 3241
32413241
32423242 - `processed_at: string`
32433243
3244 A timestamp in RFC 3339 format
3244 Timestamp when compaction was processed.
32453245
32463246 format: date-time
32473247
from line 3269
32693269
32703270 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
32713271
3272 What the client should do next in response to this error.
3272 What the client should do next.
32733273
32743274 - `BetaManagedAgentsRetryStatusRetrying object`
32753275
from line 3301
33013301
33023302 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
33033303
3304 What the client should do next in response to this error.
3304 What the client should do next.
33053305
33063306 - `BetaManagedAgentsRetryStatusRetrying object`
33073307
from line 3327
33273327
33283328 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
33293329
3330 What the client should do next in response to this error.
3330 What the client should do next.
33313331
33323332 - `BetaManagedAgentsRetryStatusRetrying object`
33333333
from line 3353
33533353
33543354 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
33553355
3356 What the client should do next in response to this error.
3356 What the client should do next.
33573357
33583358 - `BetaManagedAgentsRetryStatusRetrying object`
33593359
from line 3383
33833383
33843384 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
33853385
3386 What the client should do next in response to this error.
3386 What the client should do next.
33873387
33883388 - `BetaManagedAgentsRetryStatusRetrying object`
33893389
from line 3413
34133413
34143414 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
34153415
3416 What the client should do next in response to this error.
3416 What the client should do next.
34173417
34183418 - `BetaManagedAgentsRetryStatusRetrying object`
34193419
from line 3439
34393439
34403440 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
34413441
3442 What the client should do next in response to this error.
3442 What the client should do next.
34433443
34443444 - `BetaManagedAgentsRetryStatusRetrying object`
34453445
from line 3469
34693469
34703470 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
34713471
3472 What the client should do next in response to this error.
3472 What the client should do next.
34733473
34743474 - `BetaManagedAgentsRetryStatusRetrying object`
34753475
from line 3489
34893489
34903490 - `processed_at: string`
34913491
3492 A timestamp in RFC 3339 format
3492 Timestamp when the error occurred.
34933493
34943494 format: date-time
34953495
from line 3505
35053505
35063506 - `processed_at: string`
35073507
3508 A timestamp in RFC 3339 format
3508 Timestamp of status change.
35093509
35103510 format: date-time
35113511
from line 3521
35213521
35223522 - `processed_at: string`
35233523
3524 A timestamp in RFC 3339 format
3524 Timestamp of status change.
35253525
35263526 format: date-time
35273527
from line 3537
35373537
35383538 - `processed_at: string`
35393539
3540 A timestamp in RFC 3339 format
3540 Timestamp of status change.
35413541
35423542 format: date-time
35433543
from line 3583
35833583
35843584 - `processed_at: string`
35853585
3586 A timestamp in RFC 3339 format
3586 Timestamp of status change.
35873587
35883588 format: date-time
35893589
from line 3603
36033603
36043604 - `processed_at: string`
36053605
3606 A timestamp in RFC 3339 format
3606 Timestamp when the thread was created.
36073607
36083608 format: date-time
36093609
from line 3633
36333633
36343634 - `processed_at: string`
36353635
3636 A timestamp in RFC 3339 format
3636 Timestamp when outcome evaluation started.
36373637
36383638 format: date-time
36393639
from line 3667
36673667
36683668 - `processed_at: string`
36693669
3670 A timestamp in RFC 3339 format
3670 Timestamp when outcome evaluation ended.
36713671
36723672 format: date-time
36733673
from line 3677
36773677
36783678 - `usage: BetaManagedAgentsSpanModelUsage`
36793679
3680 Token usage for a single model request.
3680 Aggregate token usage for this evaluation cycle. Sums across all grader model requests within the cycle.
36813681
36823682 - `cache_creation_input_tokens: number`
36833683
from line 3705
37053705
37063706 - `speed: optional "standard" or "fast" or null`
37073707
3708 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.
3708 Inference speed tier this request actually ran at. Mirrors `usage.speed` on /v1/messages. Only present when the fast-mode beta is active.
37093709
37103710 - `"standard"`
37113711
from line 3723
37233723
37243724 - `processed_at: string`
37253725
3726 A timestamp in RFC 3339 format
3726 Timestamp when the model request started.
37273727
37283728 format: date-time
37293729
from line 3747
37473747
37483748 - `model_usage: BetaManagedAgentsSpanModelUsage`
37493749
3750 Token usage for a single model request.
3750 Token usage for this model request.
37513751
37523752 - `processed_at: string`
37533753
3754 A timestamp in RFC 3339 format
3754 Timestamp when the model request completed.
37553755
37563756 format: date-time
37573757
from line 3777
37773777
37783778 - `processed_at: string`
37793779
3780 A timestamp in RFC 3339 format
3780 Timestamp when this heartbeat was emitted.
37813781
37823782 format: date-time
37833783
from line 3807
38073807
38083808 - `processed_at: string`
38093809
3810 A timestamp in RFC 3339 format
3810 Timestamp when the outcome was accepted.
38113811
38123812 format: date-time
38133813
38143814 - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`
38153815
3816 Rubric for grading the quality of an outcome.
3816 How to grade the outcome. File rubrics are currently resolved to their text content; clients should handle both variants.
38173817
38183818 - `BetaManagedAgentsFileRubric object`
38193819
from line 3847
38473847
38483848 - `processed_at: string`
38493849
3850 A timestamp in RFC 3339 format
3850 Timestamp when the session was deleted.
38513851
38523852 format: date-time
38533853
from line 3867
38673867
38683868 - `processed_at: string`
38693869
3870 A timestamp in RFC 3339 format
3870 Timestamp of the status transition.
38713871
38723872 format: date-time
38733873
from line 3891
38913891
38923892 - `processed_at: string`
38933893
3894 A timestamp in RFC 3339 format
3894 Timestamp of the status transition.
38953895
38963896 format: date-time
38973897
from line 3933
39333933
39343934 - `processed_at: string`
39353935
3936 A timestamp in RFC 3339 format
3936 Timestamp of the status transition.
39373937
39383938 format: date-time
39393939
from line 3981
39813981
39823982 - `processed_at: optional string or null`
39833983
3984 A timestamp in RFC 3339 format
3984 Timestamp when this result was processed.
39853985
39863986 format: date-time
39873987
from line 4005
40054005
40064006 - `processed_at: string`
40074007
4008 A timestamp in RFC 3339 format
4008 Timestamp of the status transition.
40094009
40104010 format: date-time
40114011
from line 4025
40254025
40264026 - `processed_at: string`
40274027
4028 A timestamp in RFC 3339 format
4028 Timestamp when the update was applied.
40294029
40304030 format: date-time
40314031
40324032 - `agent: optional BetaManagedAgentsSessionAgent or null`
40334033
4034 Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
4034 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.
40354035
40364036 - `type: "agent"`
40374037
from line 4057
40574057
40584058 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
40594059
4060 - `string`
4061
40604062 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
40614063
40624064 The model that will power your agent.
from line 4125
41234125
41244126 High-performance model for agents and coding
41254127
4126 - `string`
4127
41284128 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
41294129
4130 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
4130 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.
41314131
41324132 - `BetaManagedAgentsEffortLow object`
41334133
from line 4165
41654165
41664166 - `speed: optional "standard" or "fast"`
41674167
4168 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.
4168 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.
41694169
41704170 - `"standard"`
41714171
from line 4173
41734173
41744174 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
41754175
4176 Resolved coordinator topology with full agent definitions for each roster member.
4176 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
41774177
41784178 - `type: "coordinator"`
41794179
from line 4629
46294629
46304630 - `budget: optional BetaManagedAgentsBudgetLimit or null`
46314631
4632 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
4632 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.
46334633
46344634 - `type: "limit"`
46354635
46364636 - `max_list_cost: BetaMonetaryAmount`
46374637
4638 A monetary amount in a specific currency.
4638 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.
46394639
46404640 - `amount: string`
46414641
from line 4693
46934693
46944694 - `content: BetaManagedAgentsTextBlock`
46954695
4696 Regular text content.
4696 A partial element of the content array at index, typed like the element itself — the same shape the buffered agent.message carries in content.
46974697
46984698 - `index: optional number`
46994699
47004700 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.
47014701
4702 format: uint32
4703
47044702 - `event_id: string`
47054703
47064704 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 4727
47294727
47304728 - `processed_at: optional string or null`
47314729
4732 A timestamp in RFC 3339 format
4730 Timestamp when this system message was processed.
47334731
47344732 format: date-time
47354733
from line 4743
47454743
47464744 - `processed_at: string`
47474745
4748 A timestamp in RFC 3339 format
4746 Timestamp when the snapshot was taken.
47494747
47504748 format: date-time
47514749
47524750 - `usage: BetaManagedAgentsSessionUsageSnapshot`
47534751
4754 Point-in-time snapshot of a session's cumulative usage.
4752 The session's cumulative usage at the snapshot time.
47554753
47564754 - `active_seconds: optional number`
47574755
from line 4759
47614759
47624760 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
47634761
4764 Prompt-cache creation token usage broken down by cache lifetime.
4762 Tokens used to create prompt cache entries, broken down by cache TTL.
47654763
47664764 - `ephemeral_1h_input_tokens: optional number`
47674765
from line 4787
47894787
47904788 - `list_cost: optional BetaMonetaryAmount`
47914789
4792 A monetary amount in a specific currency.
4790 Cumulative list cost of the session across all turns, priced at public list rates.
47934791
47944792 - `output_tokens: optional number`
47954793
from line 4797
47994797
48004798 - `server_tool_use: optional BetaManagedAgentsServerToolUsage`
48014799
4802 Cumulative count of server-executed tool invocations, broken down by tool.
4800 Cumulative server-executed tool usage across all turns.
48034801
48044802 - `web_fetch_requests: optional number`
48054803
from line 4813
48154813
48164814 - `budget: optional BetaManagedAgentsBudgetLimit or null`
48174815
4818 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
4816 The session's configured budget at the snapshot time, or null when the session has no budget.
48194817
48204818### Example
48214819
api/beta/sessions/threads/events/list Changed · +72 / -72 lines
from line 175
175175
176176 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
177177
178 Union type for image source variants.
178 The source of the image data.
179179
180180 - `BetaManagedAgentsBase64ImageSource object`
181181
from line 227
227227
228228 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
229229
230 Union type for document source variants.
230 The source of the document data.
231231
232232 - `BetaManagedAgentsBase64DocumentSource object`
233233
from line 303
303303
304304 - `processed_at: optional string or null`
305305
306 A timestamp in RFC 3339 format
306 Timestamp when the agent finished processing this message.
307307
308308 format: date-time
309309
from line 319
319319
320320 - `processed_at: optional string or null`
321321
322 A timestamp in RFC 3339 format
322 Timestamp when the interrupt was processed.
323323
324324 format: date-time
325325
from line 339
339339
340340 - `result: "allow" or "deny"`
341341
342 UserToolConfirmationResult enum
342 The confirmation result: 'allow' or 'deny'.
343343
344344 - `"allow"`
345345
from line 357
357357
358358 - `processed_at: optional string or null`
359359
360 A timestamp in RFC 3339 format
360 Timestamp when the confirmation was processed.
361361
362362 format: date-time
363363
from line 403
403403
404404 - `citations: BetaManagedAgentsSearchResultCitations`
405405
406 Citation settings for a search result.
406 Citation settings for this search result.
407407
408408 - `enabled: boolean`
409409
from line 439
439439
440440 - `processed_at: optional string or null`
441441
442 A timestamp in RFC 3339 format
442 Timestamp when this result was processed.
443443
444444 format: date-time
445445
from line 467
467467
468468 - `processed_at: string`
469469
470 A timestamp in RFC 3339 format
470 Timestamp when this tool use was processed.
471471
472472 format: date-time
473473
from line 499
499499
500500 - `processed_at: string`
501501
502 A timestamp in RFC 3339 format
502 Timestamp when this response was generated.
503503
504504 format: date-time
505505
from line 515
515515
516516 - `processed_at: string`
517517
518 A timestamp in RFC 3339 format
518 Timestamp when this thinking was produced.
519519
520520 format: date-time
521521
from line 543
543543
544544 - `processed_at: string`
545545
546 A timestamp in RFC 3339 format
546 Timestamp when this event was processed.
547547
548548 format: date-time
549549
550550 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
551551
552 AgentEvaluatedPermission enum
552 The evaluated permission policy for this tool invocation.
553553
554554 - `"allow"`
555555
from line 559
559559
560560 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
561561
562 Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
562 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).
563563
564564 - `BetaManagedAgentsAgentToolEvaluationAlwaysAllow object`
565565
from line 581
581581
582582 - `evaluated_permission: BetaManagedAgentsAgentAutoEvaluatedPermission`
583583
584 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.
584 The server's judgement for this invocation.
585585
586586 - `BetaManagedAgentsAgentAutoEvaluatedPermissionAllow object`
587587
from line 633
633633
634634 - `processed_at: string`
635635
636 A timestamp in RFC 3339 format
636 Timestamp when this event was processed.
637637
638638 format: date-time
639639
from line 681
681681
682682 - `processed_at: string`
683683
684 A timestamp in RFC 3339 format
684 Timestamp when this event was processed.
685685
686686 format: date-time
687687
688688 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
689689
690 AgentEvaluatedPermission enum
690 The evaluated permission policy for this tool invocation.
691691
692692 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
693693
694 Names the resolved permission_policy that produced evaluated_permission, and under auto carries the judgement. Open union: clients must tolerate unknown variants.
694 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).
695695
696696 - `session_thread_id: optional string or null`
697697
from line 709
709709
710710 - `processed_at: string`
711711
712 A timestamp in RFC 3339 format
712 Timestamp when this event was processed.
713713
714714 format: date-time
715715
from line 777
777777
778778 - `processed_at: string`
779779
780 A timestamp in RFC 3339 format
780 Timestamp when the message was received.
781781
782782 format: date-time
783783
from line 817
817817
818818 - `processed_at: string`
819819
820 A timestamp in RFC 3339 format
820 Timestamp when the message was sent.
821821
822822 format: date-time
823823
from line 841
841841
842842 - `processed_at: string`
843843
844 A timestamp in RFC 3339 format
844 Timestamp when compaction was processed.
845845
846846 format: date-time
847847
from line 869
869869
870870 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
871871
872 What the client should do next in response to this error.
872 What the client should do next.
873873
874874 - `BetaManagedAgentsRetryStatusRetrying object`
875875
from line 901
901901
902902 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
903903
904 What the client should do next in response to this error.
904 What the client should do next.
905905
906906 - `BetaManagedAgentsRetryStatusRetrying object`
907907
from line 927
927927
928928 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
929929
930 What the client should do next in response to this error.
930 What the client should do next.
931931
932932 - `BetaManagedAgentsRetryStatusRetrying object`
933933
from line 953
953953
954954 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
955955
956 What the client should do next in response to this error.
956 What the client should do next.
957957
958958 - `BetaManagedAgentsRetryStatusRetrying object`
959959
from line 983
983983
984984 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
985985
986 What the client should do next in response to this error.
986 What the client should do next.
987987
988988 - `BetaManagedAgentsRetryStatusRetrying object`
989989
from line 1013
10131013
10141014 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
10151015
1016 What the client should do next in response to this error.
1016 What the client should do next.
10171017
10181018 - `BetaManagedAgentsRetryStatusRetrying object`
10191019
from line 1039
10391039
10401040 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
10411041
1042 What the client should do next in response to this error.
1042 What the client should do next.
10431043
10441044 - `BetaManagedAgentsRetryStatusRetrying object`
10451045
from line 1069
10691069
10701070 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
10711071
1072 What the client should do next in response to this error.
1072 What the client should do next.
10731073
10741074 - `BetaManagedAgentsRetryStatusRetrying object`
10751075
from line 1089
10891089
10901090 - `processed_at: string`
10911091
1092 A timestamp in RFC 3339 format
1092 Timestamp when the error occurred.
10931093
10941094 format: date-time
10951095
from line 1105
11051105
11061106 - `processed_at: string`
11071107
1108 A timestamp in RFC 3339 format
1108 Timestamp of status change.
11091109
11101110 format: date-time
11111111
from line 1121
11211121
11221122 - `processed_at: string`
11231123
1124 A timestamp in RFC 3339 format
1124 Timestamp of status change.
11251125
11261126 format: date-time
11271127
from line 1137
11371137
11381138 - `processed_at: string`
11391139
1140 A timestamp in RFC 3339 format
1140 Timestamp of status change.
11411141
11421142 format: date-time
11431143
from line 1183
11831183
11841184 - `processed_at: string`
11851185
1186 A timestamp in RFC 3339 format
1186 Timestamp of status change.
11871187
11881188 format: date-time
11891189
from line 1203
12031203
12041204 - `processed_at: string`
12051205
1206 A timestamp in RFC 3339 format
1206 Timestamp when the thread was created.
12071207
12081208 format: date-time
12091209
from line 1233
12331233
12341234 - `processed_at: string`
12351235
1236 A timestamp in RFC 3339 format
1236 Timestamp when outcome evaluation started.
12371237
12381238 format: date-time
12391239
from line 1267
12671267
12681268 - `processed_at: string`
12691269
1270 A timestamp in RFC 3339 format
1270 Timestamp when outcome evaluation ended.
12711271
12721272 format: date-time
12731273
from line 1277
12771277
12781278 - `usage: BetaManagedAgentsSpanModelUsage`
12791279
1280 Token usage for a single model request.
1280 Aggregate token usage for this evaluation cycle. Sums across all grader model requests within the cycle.
12811281
12821282 - `cache_creation_input_tokens: number`
12831283
from line 1305
13051305
13061306 - `speed: optional "standard" or "fast" or null`
13071307
1308 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.
1308 Inference speed tier this request actually ran at. Mirrors `usage.speed` on /v1/messages. Only present when the fast-mode beta is active.
13091309
13101310 - `"standard"`
13111311
from line 1323
13231323
13241324 - `processed_at: string`
13251325
1326 A timestamp in RFC 3339 format
1326 Timestamp when the model request started.
13271327
13281328 format: date-time
13291329
from line 1347
13471347
13481348 - `model_usage: BetaManagedAgentsSpanModelUsage`
13491349
1350 Token usage for a single model request.
1350 Token usage for this model request.
13511351
13521352 - `processed_at: string`
13531353
1354 A timestamp in RFC 3339 format
1354 Timestamp when the model request completed.
13551355
13561356 format: date-time
13571357
from line 1377
13771377
13781378 - `processed_at: string`
13791379
1380 A timestamp in RFC 3339 format
1380 Timestamp when this heartbeat was emitted.
13811381
13821382 format: date-time
13831383
from line 1407
14071407
14081408 - `processed_at: string`
14091409
1410 A timestamp in RFC 3339 format
1410 Timestamp when the outcome was accepted.
14111411
14121412 format: date-time
14131413
14141414 - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`
14151415
1416 Rubric for grading the quality of an outcome.
1416 How to grade the outcome. File rubrics are currently resolved to their text content; clients should handle both variants.
14171417
14181418 - `BetaManagedAgentsFileRubric object`
14191419
from line 1447
14471447
14481448 - `processed_at: string`
14491449
1450 A timestamp in RFC 3339 format
1450 Timestamp when the session was deleted.
14511451
14521452 format: date-time
14531453
from line 1467
14671467
14681468 - `processed_at: string`
14691469
1470 A timestamp in RFC 3339 format
1470 Timestamp of the status transition.
14711471
14721472 format: date-time
14731473
from line 1491
14911491
14921492 - `processed_at: string`
14931493
1494 A timestamp in RFC 3339 format
1494 Timestamp of the status transition.
14951495
14961496 format: date-time
14971497
from line 1533
15331533
15341534 - `processed_at: string`
15351535
1536 A timestamp in RFC 3339 format
1536 Timestamp of the status transition.
15371537
15381538 format: date-time
15391539
from line 1581
15811581
15821582 - `processed_at: optional string or null`
15831583
1584 A timestamp in RFC 3339 format
1584 Timestamp when this result was processed.
15851585
15861586 format: date-time
15871587
from line 1605
16051605
16061606 - `processed_at: string`
16071607
1608 A timestamp in RFC 3339 format
1608 Timestamp of the status transition.
16091609
16101610 format: date-time
16111611
from line 1625
16251625
16261626 - `processed_at: string`
16271627
1628 A timestamp in RFC 3339 format
1628 Timestamp when the update was applied.
16291629
16301630 format: date-time
16311631
16321632 - `agent: optional BetaManagedAgentsSessionAgent or null`
16331633
1634 Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session` creation time.
1634 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.
16351635
16361636 - `type: "agent"`
16371637
from line 1657
16571657
16581658 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
16591659
1660 - `string`
1661
16601662 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
16611663
16621664 The model that will power your agent.
from line 1725
17231725
17241726 High-performance model for agents and coding
17251727
1726 - `string`
1727
17281728 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
17291729
1730 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
1730 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.
17311731
17321732 - `BetaManagedAgentsEffortLow object`
17331733
from line 1765
17651765
17661766 - `speed: optional "standard" or "fast"`
17671767
1768 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.
1768 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.
17691769
17701770 - `"standard"`
17711771
from line 1773
17731773
17741774 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
17751775
1776 Resolved coordinator topology with full agent definitions for each roster member.
1776 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
17771777
17781778 - `type: "coordinator"`
17791779
from line 2229
22292229
22302230 - `budget: optional BetaManagedAgentsBudgetLimit or null`
22312231
2232 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
2232 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.
22332233
22342234 - `type: "limit"`
22352235
22362236 - `max_list_cost: BetaMonetaryAmount`
22372237
2238 A monetary amount in a specific currency.
2238 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.
22392239
22402240 - `amount: string`
22412241
from line 2277
22772277
22782278 - `processed_at: optional string or null`
22792279
2280 A timestamp in RFC 3339 format
2280 Timestamp when this system message was processed.
22812281
22822282 format: date-time
22832283
from line 2293
22932293
22942294 - `processed_at: string`
22952295
2296 A timestamp in RFC 3339 format
2296 Timestamp when the snapshot was taken.
22972297
22982298 format: date-time
22992299
23002300 - `usage: BetaManagedAgentsSessionUsageSnapshot`
23012301
2302 Point-in-time snapshot of a session's cumulative usage.
2302 The session's cumulative usage at the snapshot time.
23032303
23042304 - `active_seconds: optional number`
23052305
from line 2309
23092309
23102310 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
23112311
2312 Prompt-cache creation token usage broken down by cache lifetime.
2312 Tokens used to create prompt cache entries, broken down by cache TTL.
23132313
23142314 - `ephemeral_1h_input_tokens: optional number`
23152315
from line 2337
23372337
23382338 - `list_cost: optional BetaMonetaryAmount`
23392339
2340 A monetary amount in a specific currency.
2340 Cumulative list cost of the session across all turns, priced at public list rates.
23412341
23422342 - `output_tokens: optional number`
23432343
from line 2347
23472347
23482348 - `server_tool_use: optional BetaManagedAgentsServerToolUsage`
23492349
2350 Cumulative count of server-executed tool invocations, broken down by tool.
2350 Cumulative server-executed tool usage across all turns.
23512351
23522352 - `web_fetch_requests: optional number`
23532353
from line 2363
23632363
23642364 - `budget: optional BetaManagedAgentsBudgetLimit or null`
23652365
2366 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
2366 The session's configured budget at the snapshot time, or null when the session has no budget.
23672367
23682368- `next_page: optional string or null`
23692369
api/beta/sessions/threads/events/stream Changed · +73 / -75 lines
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
api/beta/sessions/threads/list Changed · +14 / -14 lines
from line 151
151151
152152 - `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
153153
154 The resolved agent a `session_thread` runs.
154 Resolved agent definition for this thread. Snapshot of the agent at thread creation time.
155155
156156 - `BetaManagedAgentsSessionThreadAgent object`
157157
from line 181
181181
182182 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
183183
184 - `string`
185
184186 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
185187
186188 The model that will power your agent.
from line 249
247249
248250 High-performance model for agents and coding
249251
250 - `string`
251
252252 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
253253
254 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
254 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.
255255
256256 - `BetaManagedAgentsEffortLow object`
257257
from line 289
289289
290290 - `speed: optional "standard" or "fast"`
291291
292 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.
292 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.
293293
294294 - `"standard"`
295295
from line 693
693693
694694 - `archived_at: string or null`
695695
696 A timestamp in RFC 3339 format
696 When the thread was archived. Null if not archived.
697697
698698 format: date-time
699699
700700 - `created_at: string`
701701
702 A timestamp in RFC 3339 format
702 When the thread was created.
703703
704704 format: date-time
705705
from line 713
713713
714714 - `stats: BetaManagedAgentsSessionThreadStats or null`
715715
716 Timing statistics for a session thread.
716 Timing statistics for this thread. Null until the thread's first status transition.
717717
718718 - `active_seconds: optional number`
719719
from line 735
735735
736736 - `status: BetaManagedAgentsSessionThreadStatus`
737737
738 SessionThreadStatus enum
738 Current execution status of the thread.
739739
740740 - `"running"`
741741
from line 747
747747
748748 - `updated_at: string`
749749
750 A timestamp in RFC 3339 format
750 When the thread was last updated.
751751
752752 format: date-time
753753
754754 - `usage: BetaManagedAgentsSessionThreadUsage or null`
755755
756 Cumulative token usage for a session thread across all turns.
756 Cumulative token usage for this thread. Null until the thread's first idle transition.
757757
758758 - `active_seconds: optional number`
759759
from line 763
763763
764764 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
765765
766 Prompt-cache creation token usage broken down by cache lifetime.
766 Tokens used to create prompt cache entries, broken down by cache TTL.
767767
768768 - `ephemeral_1h_input_tokens: optional number`
769769
from line 791
791791
792792 - `list_cost: optional BetaMonetaryAmount or null`
793793
794 A monetary amount in a specific currency.
794 Cumulative list cost of this thread across all turns, priced at public list rates. Absent until cost tracking is available for the thread. Each figure is rounded to the nearest cent independently and the session's aggregate `usage.list_cost` additionally includes session runtime, so per-thread costs do not sum exactly to the session figure; the session figure is authoritative and is what a budget is enforced against.
795795
796796 - `amount: string`
797797
from line 809
809809
810810 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
811811
812 Cumulative count of server-executed tool invocations, broken down by tool.
812 Cumulative server-executed tool usage across all turns of this thread. Absent until server-tool tracking is available for the thread.
813813
814814 - `web_fetch_requests: optional number`
815815
api/beta/sessions/threads/retrieve Changed · +14 / -14 lines
from line 141
141141
142142 - `agent: BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
143143
144 The resolved agent a `session_thread` runs.
144 Resolved agent definition for this thread. Snapshot of the agent at thread creation time.
145145
146146 - `BetaManagedAgentsSessionThreadAgent object`
147147
from line 171
171171
172172 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
173173
174 - `string`
175
174176 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
175177
176178 The model that will power your agent.
from line 239
237239
238240 High-performance model for agents and coding
239241
240 - `string`
241
242242 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
243243
244 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
244 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.
245245
246246 - `BetaManagedAgentsEffortLow object`
247247
from line 279
279279
280280 - `speed: optional "standard" or "fast"`
281281
282 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.
282 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.
283283
284284 - `"standard"`
285285
from line 683
683683
684684 - `archived_at: string or null`
685685
686 A timestamp in RFC 3339 format
686 When the thread was archived. Null if not archived.
687687
688688 format: date-time
689689
690690 - `created_at: string`
691691
692 A timestamp in RFC 3339 format
692 When the thread was created.
693693
694694 format: date-time
695695
from line 703
703703
704704 - `stats: BetaManagedAgentsSessionThreadStats or null`
705705
706 Timing statistics for a session thread.
706 Timing statistics for this thread. Null until the thread's first status transition.
707707
708708 - `active_seconds: optional number`
709709
from line 725
725725
726726 - `status: BetaManagedAgentsSessionThreadStatus`
727727
728 SessionThreadStatus enum
728 Current execution status of the thread.
729729
730730 - `"running"`
731731
from line 737
737737
738738 - `updated_at: string`
739739
740 A timestamp in RFC 3339 format
740 When the thread was last updated.
741741
742742 format: date-time
743743
744744 - `usage: BetaManagedAgentsSessionThreadUsage or null`
745745
746 Cumulative token usage for a session thread across all turns.
746 Cumulative token usage for this thread. Null until the thread's first idle transition.
747747
748748 - `active_seconds: optional number`
749749
from line 753
753753
754754 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
755755
756 Prompt-cache creation token usage broken down by cache lifetime.
756 Tokens used to create prompt cache entries, broken down by cache TTL.
757757
758758 - `ephemeral_1h_input_tokens: optional number`
759759
from line 781
781781
782782 - `list_cost: optional BetaMonetaryAmount or null`
783783
784 A monetary amount in a specific currency.
784 Cumulative list cost of this thread across all turns, priced at public list rates. Absent until cost tracking is available for the thread. Each figure is rounded to the nearest cent independently and the session's aggregate `usage.list_cost` additionally includes session runtime, so per-thread costs do not sum exactly to the session figure; the session figure is authoritative and is what a budget is enforced against.
785785
786786 - `amount: string`
787787
from line 799
799799
800800 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
801801
802 Cumulative count of server-executed tool invocations, broken down by tool.
802 Cumulative server-executed tool usage across all turns of this thread. Absent until server-tool tracking is available for the thread.
803803
804804 - `web_fetch_requests: optional number`
805805
api/beta/sessions/update Changed · +267 / -267 lines
from line 129
129129
130130- `agent: optional BetaManagedAgentsSessionAgentUpdate`
131131
132 Mid-session agent configuration update. Only `tools` and `mcp_servers` are updatable. Full replacement: the provided array becomes the new value. To preserve existing entries, GET the session, modify the array, and POST it back.
132 Agent configuration update. Only `tools` and `mcp_servers` are updatable mid-session. Only valid for sessions created from an agent or deployment reference. The session must not be running.
133133
134134 - `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams`
135135
from line 179
179179
180180 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
181181
182 Permission policy for tool execution.
182 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
183183
184184 - `BetaManagedAgentsAlwaysAllowPolicy object`
185185
from line 215
215215
216216 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
217217
218 Permission policy for tool execution.
218 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
219219
220220 - `BetaManagedAgentsAlwaysAllowPolicy object`
221221
from line 245
245245
246246 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
247247
248 Permission policy for tool execution.
248 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
249249
250250 - `BetaManagedAgentsAlwaysAllowPolicy object`
251251
from line 275
275275
276276 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
277277
278 Permission policy for tool execution.
278 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
279279
280280 - `BetaManagedAgentsAlwaysAllowPolicy object`
281281
from line 305
305305
306306 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
307307
308 Permission policy for tool execution.
308 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
309309
310310 - `BetaManagedAgentsAlwaysAllowPolicy object`
311311
from line 335
335335
336336 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
337337
338 Permission policy for tool execution.
338 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
339339
340340 - `BetaManagedAgentsAlwaysAllowPolicy object`
341341
from line 379
379379
380380 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
381381
382 Permission policy for tool execution.
382 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
383383
384384 - `BetaManagedAgentsAlwaysAllowPolicy object`
385385
from line 417
417417
418418 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
419419
420 Permission policy for tool execution.
420 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
421421
422422 - `BetaManagedAgentsAlwaysAllowPolicy object`
423423
from line 463
463463
464464 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
465465
466 Default configuration for all tools in a toolset.
466 Default configuration applied to all tools in this set.
467467
468468 - `enabled: optional boolean or null`
469469
from line 471
471471
472472 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
473473
474 Permission policy for tool execution.
474 Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
475475
476476 - `BetaManagedAgentsAlwaysAllowPolicy object`
477477
from line 513
513513
514514 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
515515
516 Permission policy for tool execution.
516 Permission policy for this tool. Overrides the `default_config` setting.
517517
518518 - `BetaManagedAgentsAlwaysAllowPolicy object`
519519
from line 529
529529
530530 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
531531
532 Default configuration for all tools from an MCP server.
532 Default configuration for all tools from this server.
533533
534534 - `enabled: optional boolean or null`
535535
from line 537
537537
538538 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
539539
540 Permission policy for tool execution.
540 Default permission policy for tools from this server.
541541
542542 - `BetaManagedAgentsAlwaysAllowPolicy object`
543543
from line 565
565565
566566 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
567567
568 JSON Schema for custom tool input parameters.
568 JSON Schema defining the expected input parameters for the tool.
569569
570570 - `type: "object"`
571571
from line 581
581581
582582- `budget: optional BetaManagedAgentsBudgetLimit or null`
583583
584 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
584 Enforced spend ceiling for the session. Set an object to replace the budget of a session that was created with one, or `null` to remove it; omit to preserve. A budget cannot be added to a session created without one (rejected with reason `budget_create_only`), and a removed budget cannot be re-added. Allowed in any non-terminated status. Lowering `max_list_cost` to at or below the session's consumed list cost is rejected with reason `budget_not_raised`, and every model the session can run must have a public list price or the request is rejected with reason `model_not_budgetable`.
585585
586586 - `type: "limit"`
587587
588588 - `max_list_cost: BetaMonetaryAmount`
589589
590 A monetary amount in a specific currency.
590 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.
591591
592592 - `amount: string`
593593
from line 649
649649
650650 See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
651651
652 - `string`
653
652654 - `"claude-opus-5-5" or "claude-fable-5-1" or "claude-sonnet-5" or 12 more`
653655
654656 The model that will power your agent.
from line 717
715717
716718 High-performance model for agents and coding
717719
718 - `string`
719
720720 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
721721
722 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
722 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.
723723
724724 - `BetaManagedAgentsEffortLow object`
725725
from line 757
757757
758758 - `speed: optional "standard" or "fast"`
759759
760 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.
760 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.
761761
762762 - `"standard"`
763763
from line 765
765765
766766 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
767767
768 Resolved coordinator topology with full agent definitions for each roster member.
768 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
769769
770770 - `type: "coordinator"`
771771
from line 1221
12211221
12221222 - `archived_at: string or null`
12231223
1224 A timestamp in RFC 3339 format
1224 When the session was archived. Null if not archived.
12251225
12261226 format: date-time
12271227
12281228 - `budget: BetaManagedAgentsBudgetLimit or null`
12291229
1230 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
1230 The session's enforced spend ceiling, or null when no budget is set.
12311231
12321232 - `type: "limit"`
12331233
12341234 - `max_list_cost: BetaMonetaryAmount`
12351235
1236 A monetary amount in a specific currency.
1236 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.
12371237
12381238 - `amount: string`
12391239
from line 1261
12611261
12621262 - `completed_at: string or null`
12631263
1264 A timestamp in RFC 3339 format
1264 When the outcome reached a terminal result. Null while `pending`/`running`/`evaluating`.
12651265
12661266 format: date-time
12671267
from line 1367
13671367
13681368 - `access: optional "read_write" or "read_only" or null`
13691369
1370 Access mode for an attached memory store.
1370 Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts the store as a read-only filesystem.
13711371
13721372 - `"read_write"`
13731373
from line 1393
13931393
13941394 - `stats: BetaManagedAgentsSessionStats`
13951395
1396 Timing statistics for a session.
1396 Timing statistics for the session.
13971397
13981398 - `active_seconds: optional number`
13991399
from line 1437
14371437
14381438 - `usage: BetaManagedAgentsSessionUsage`
14391439
1440 Cumulative token usage for a session across all turns.
1440 Cumulative token usage for the session.
14411441
14421442 - `active_seconds: optional number`
14431443
from line 1447
14471447
14481448 - `cache_creation: optional BetaManagedAgentsCacheCreationUsage`
14491449
1450 Prompt-cache creation token usage broken down by cache lifetime.
1450 Tokens used to create prompt cache entries, broken down by cache TTL.
14511451
14521452 - `ephemeral_1h_input_tokens: optional number`
14531453
from line 1475
14751475
14761476 - `list_cost: optional BetaMonetaryAmount or null`
14771477
1478 A monetary amount in a specific currency.
1478 Cumulative list cost of the session across all turns, priced at public list rates. Absent until cost tracking is available for the session.
14791479
14801480 - `output_tokens: optional number`
14811481
from line 1485
14851485
14861486 - `server_tool_use: optional BetaManagedAgentsServerToolUsage or null`
14871487
1488 Cumulative count of server-executed tool invocations, broken down by tool.
1488 Cumulative server-executed tool usage across all turns. Absent until server-tool tracking is available for the session.
14891489
14901490 - `web_fetch_requests: optional number`
14911491
api/beta/tunnels Changed · +22 / -22 lines
from line 147
147147
148148 - `archived_at: string or null`
149149
150 A timestamp in RFC 3339 format
150 RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.
151151
152152 format: date-time
153153
154154 - `created_at: string`
155155
156 A timestamp in RFC 3339 format
156 RFC 3339 datetime string indicating when the tunnel was created.
157157
158158 format: date-time
159159
from line 329
329329
330330 - `archived_at: string or null`
331331
332 A timestamp in RFC 3339 format
332 RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.
333333
334334 format: date-time
335335
336336 - `created_at: string`
337337
338 A timestamp in RFC 3339 format
338 RFC 3339 datetime string indicating when the tunnel was created.
339339
340340 format: date-time
341341
from line 519
519519
520520 - `archived_at: string or null`
521521
522 A timestamp in RFC 3339 format
522 RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.
523523
524524 format: date-time
525525
526526 - `created_at: string`
527527
528 A timestamp in RFC 3339 format
528 RFC 3339 datetime string indicating when the tunnel was created.
529529
530530 format: date-time
531531
from line 708
708708
709709 - `archived_at: string or null`
710710
711 A timestamp in RFC 3339 format
711 RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.
712712
713713 format: date-time
714714
715715 - `created_at: string`
716716
717 A timestamp in RFC 3339 format
717 RFC 3339 datetime string indicating when the tunnel was created.
718718
719719 format: date-time
720720
from line 1098
10981098
10991099 - `archived_at: string or null`
11001100
1101 A timestamp in RFC 3339 format
1101 RFC 3339 datetime string indicating when the tunnel was archived. Null if it is not archived.
11021102
11031103 format: date-time
11041104
11051105 - `created_at: string`
11061106
1107 A timestamp in RFC 3339 format
1107 RFC 3339 datetime string indicating when the tunnel was created.
11081108
11091109 format: date-time
11101110
from line 1282
12821282
12831283 - `archived_at: string or null`
12841284
1285 A timestamp in RFC 3339 format
1285 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
12861286
12871287 format: date-time
12881288
12891289 - `created_at: string`
12901290
1291 A timestamp in RFC 3339 format
1291 RFC 3339 datetime string indicating when the certificate was registered.
12921292
12931293 format: date-time
12941294
12951295 - `expires_at: string or null`
12961296
1297 A timestamp in RFC 3339 format
1297 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
12981298
12991299 format: date-time
13001300
from line 1477
14771477
14781478 - `archived_at: string or null`
14791479
1480 A timestamp in RFC 3339 format
1480 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
14811481
14821482 format: date-time
14831483
14841484 - `created_at: string`
14851485
1486 A timestamp in RFC 3339 format
1486 RFC 3339 datetime string indicating when the certificate was registered.
14871487
14881488 format: date-time
14891489
14901490 - `expires_at: string or null`
14911491
1492 A timestamp in RFC 3339 format
1492 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
14931493
14941494 format: date-time
14951495
from line 1680
16801680
16811681 - `archived_at: string or null`
16821682
1683 A timestamp in RFC 3339 format
1683 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
16841684
16851685 format: date-time
16861686
16871687 - `created_at: string`
16881688
1689 A timestamp in RFC 3339 format
1689 RFC 3339 datetime string indicating when the certificate was registered.
16901690
16911691 format: date-time
16921692
16931693 - `expires_at: string or null`
16941694
1695 A timestamp in RFC 3339 format
1695 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
16961696
16971697 format: date-time
16981698
from line 1880
18801880
18811881 - `archived_at: string or null`
18821882
1883 A timestamp in RFC 3339 format
1883 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
18841884
18851885 format: date-time
18861886
18871887 - `created_at: string`
18881888
1889 A timestamp in RFC 3339 format
1889 RFC 3339 datetime string indicating when the certificate was registered.
18901890
18911891 format: date-time
18921892
18931893 - `expires_at: string or null`
18941894
1895 A timestamp in RFC 3339 format
1895 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
18961896
18971897 format: date-time
18981898
api/beta/tunnels/certificates Changed · +15 / -15 lines
from line 153
153153
154154 - `archived_at: string or null`
155155
156 A timestamp in RFC 3339 format
156 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
157157
158158 format: date-time
159159
160160 - `created_at: string`
161161
162 A timestamp in RFC 3339 format
162 RFC 3339 datetime string indicating when the certificate was registered.
163163
164164 format: date-time
165165
166166 - `expires_at: string or null`
167167
168 A timestamp in RFC 3339 format
168 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
169169
170170 format: date-time
171171
from line 348
348348
349349 - `archived_at: string or null`
350350
351 A timestamp in RFC 3339 format
351 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
352352
353353 format: date-time
354354
355355 - `created_at: string`
356356
357 A timestamp in RFC 3339 format
357 RFC 3339 datetime string indicating when the certificate was registered.
358358
359359 format: date-time
360360
361361 - `expires_at: string or null`
362362
363 A timestamp in RFC 3339 format
363 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
364364
365365 format: date-time
366366
from line 551
551551
552552 - `archived_at: string or null`
553553
554 A timestamp in RFC 3339 format
554 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
555555
556556 format: date-time
557557
558558 - `created_at: string`
559559
560 A timestamp in RFC 3339 format
560 RFC 3339 datetime string indicating when the certificate was registered.
561561
562562 format: date-time
563563
564564 - `expires_at: string or null`
565565
566 A timestamp in RFC 3339 format
566 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
567567
568568 format: date-time
569569
from line 751
751751
752752 - `archived_at: string or null`
753753
754 A timestamp in RFC 3339 format
754 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
755755
756756 format: date-time
757757
758758 - `created_at: string`
759759
760 A timestamp in RFC 3339 format
760 RFC 3339 datetime string indicating when the certificate was registered.
761761
762762 format: date-time
763763
764764 - `expires_at: string or null`
765765
766 A timestamp in RFC 3339 format
766 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
767767
768768 format: date-time
769769
from line 815
815815
816816 - `archived_at: string or null`
817817
818 A timestamp in RFC 3339 format
818 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
819819
820820 format: date-time
821821
822822 - `created_at: string`
823823
824 A timestamp in RFC 3339 format
824 RFC 3339 datetime string indicating when the certificate was registered.
825825
826826 format: date-time
827827
828828 - `expires_at: string or null`
829829
830 A timestamp in RFC 3339 format
830 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
831831
832832 format: date-time
833833
api/beta/tunnels/certificates/archive Changed · +3 / -3 lines
from line 147
147147
148148 - `archived_at: string or null`
149149
150 A timestamp in RFC 3339 format
150 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
151151
152152 format: date-time
153153
154154 - `created_at: string`
155155
156 A timestamp in RFC 3339 format
156 RFC 3339 datetime string indicating when the certificate was registered.
157157
158158 format: date-time
159159
160160 - `expires_at: string or null`
161161
162 A timestamp in RFC 3339 format
162 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
163163
164164 format: date-time
165165
api/beta/tunnels/certificates/create Changed · +3 / -3 lines
from line 151
151151
152152 - `archived_at: string or null`
153153
154 A timestamp in RFC 3339 format
154 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
155155
156156 format: date-time
157157
158158 - `created_at: string`
159159
160 A timestamp in RFC 3339 format
160 RFC 3339 datetime string indicating when the certificate was registered.
161161
162162 format: date-time
163163
164164 - `expires_at: string or null`
165165
166 A timestamp in RFC 3339 format
166 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
167167
168168 format: date-time
169169
api/beta/tunnels/certificates/list Changed · +3 / -3 lines
from line 159
159159
160160 - `archived_at: string or null`
161161
162 A timestamp in RFC 3339 format
162 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
163163
164164 format: date-time
165165
166166 - `created_at: string`
167167
168 A timestamp in RFC 3339 format
168 RFC 3339 datetime string indicating when the certificate was registered.
169169
170170 format: date-time
171171
172172 - `expires_at: string or null`
173173
174 A timestamp in RFC 3339 format
174 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
175175
176176 format: date-time
177177
api/beta/tunnels/certificates/retrieve Changed · +3 / -3 lines
from line 147
147147
148148 - `archived_at: string or null`
149149
150 A timestamp in RFC 3339 format
150 RFC 3339 datetime string indicating when the certificate was archived. Null if it is still in the trusted set.
151151
152152 format: date-time
153153
154154 - `created_at: string`
155155
156 A timestamp in RFC 3339 format
156 RFC 3339 datetime string indicating when the certificate was registered.
157157
158158 format: date-time
159159
160160 - `expires_at: string or null`
161161
162 A timestamp in RFC 3339 format
162 RFC 3339 datetime string indicating when the certificate expires, or `null` if it does not expire.
163163
164164 format: date-time
165165
api/beta/user_profiles Changed · +58 / -58 lines
from line 127
127127
128128- `access_type: optional "application" or "passthrough"`
129129
130 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
130 How the platform uses the API for this entity. `application` (default): the profile represents an individual end-user of the platform's product. `passthrough`: the profile identifies a company the platform resells Claude access to.
131131
132132 - `"application"`
133133
from line 149
149149
150150 - `account_status: optional "active" or "suspended" or "blocked" or null`
151151
152 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
152 The status of the entity's account on the platform: `active`, `suspended` or `blocked`.
153153
154154 - `"active"`
155155
from line 175
175175
176176 - `entity_type: optional "individual" or "business" or "non_profit" or "government" or null`
177177
178 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
178 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`.
179179
180180 - `"individual"`
181181
from line 193
193193
194194 - `onboarded_at: optional string`
195195
196 A timestamp in RFC 3339 format
196 When the entity opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.
197197
198198 format: date-time
199199
from line 205
205205
206206- `external_user_onboarded_at: optional string`
207207
208 A timestamp in RFC 3339 format
208 When the entity this profile represents opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future. Optional. Accepted under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` send `external_user_details.onboarded_at` instead.
209209
210210 format: date-time
211211
from line 237
237237
238238 - `created_at: string`
239239
240 A timestamp in RFC 3339 format
240 When this user profile was created, in RFC 3339 format.
241241
242242 format: date-time
243243
from line 261
261261
262262 - `updated_at: string`
263263
264 A timestamp in RFC 3339 format
264 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
265265
266266 format: date-time
267267
268268 - `access_type: optional "application" or "passthrough"`
269269
270 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
270 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
271271
272272 - `"application"`
273273
from line 283
283283
284284 - `external_user_details: optional BetaUserProfileExternalUserDetails`
285285
286 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
286 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
287287
288288 - `account_status: "active" or "suspended" or "blocked" or null`
289289
290 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
290 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
291291
292292 - `"active"`
293293
from line 311
311311
312312 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
313313
314 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
314 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
315315
316316 - `"individual"`
317317
from line 327
327327
328328 - `onboarded_at: string or null`
329329
330 A timestamp in RFC 3339 format
330 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
331331
332332 format: date-time
333333
from line 337
337337
338338 - `external_user_onboarded_at: optional string or null`
339339
340 A timestamp in RFC 3339 format
340 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
341341
342342 format: date-time
343343
from line 562
562562
563563 - `created_at: string`
564564
565 A timestamp in RFC 3339 format
565 When this user profile was created, in RFC 3339 format.
566566
567567 format: date-time
568568
from line 586
586586
587587 - `updated_at: string`
588588
589 A timestamp in RFC 3339 format
589 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
590590
591591 format: date-time
592592
593593 - `access_type: optional "application" or "passthrough"`
594594
595 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
595 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
596596
597597 - `"application"`
598598
from line 608
608608
609609 - `external_user_details: optional BetaUserProfileExternalUserDetails`
610610
611 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
611 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
612612
613613 - `account_status: "active" or "suspended" or "blocked" or null`
614614
615 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
615 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
616616
617617 - `"active"`
618618
from line 636
636636
637637 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
638638
639 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
639 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
640640
641641 - `"individual"`
642642
from line 652
652652
653653 - `onboarded_at: string or null`
654654
655 A timestamp in RFC 3339 format
655 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
656656
657657 format: date-time
658658
from line 662
662662
663663 - `external_user_onboarded_at: optional string or null`
664664
665 A timestamp in RFC 3339 format
665 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
666666
667667 format: date-time
668668
from line 860
860860
861861 - `created_at: string`
862862
863 A timestamp in RFC 3339 format
863 When this user profile was created, in RFC 3339 format.
864864
865865 format: date-time
866866
from line 884
884884
885885 - `updated_at: string`
886886
887 A timestamp in RFC 3339 format
887 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
888888
889889 format: date-time
890890
891891 - `access_type: optional "application" or "passthrough"`
892892
893 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
893 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
894894
895895 - `"application"`
896896
from line 906
906906
907907 - `external_user_details: optional BetaUserProfileExternalUserDetails`
908908
909 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
909 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
910910
911911 - `account_status: "active" or "suspended" or "blocked" or null`
912912
913 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
913 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
914914
915915 - `"active"`
916916
from line 934
934934
935935 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
936936
937 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
937 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
938938
939939 - `"individual"`
940940
from line 950
950950
951951 - `onboarded_at: string or null`
952952
953 A timestamp in RFC 3339 format
953 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
954954
955955 format: date-time
956956
from line 960
960960
961961 - `external_user_onboarded_at: optional string or null`
962962
963 A timestamp in RFC 3339 format
963 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
964964
965965 format: date-time
966966
from line 1135
11351135
11361136- `access_type: optional "application" or "passthrough" or null`
11371137
1138 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
1138 If present, replaces the stored access type. Omit to leave unchanged.
11391139
11401140 - `"application"`
11411141
from line 1157
11571157
11581158 - `account_status: optional "active" or "suspended" or "blocked" or null`
11591159
1160 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
1160 The status of the entity's account on the platform: `active`, `suspended` or `blocked`.
11611161
11621162 - `"active"`
11631163
from line 1183
11831183
11841184 - `entity_type: optional "individual" or "business" or "non_profit" or "government" or null`
11851185
1186 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
1186 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`.
11871187
11881188 - `"individual"`
11891189
from line 1201
12011201
12021202 - `onboarded_at: optional string`
12031203
1204 A timestamp in RFC 3339 format
1204 When the entity opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.
12051205
12061206 format: date-time
12071207
from line 1213
12131213
12141214- `external_user_onboarded_at: optional string`
12151215
1216 A timestamp in RFC 3339 format
1216 If present, replaces the stored account creation time. Omit to leave unchanged; once set, the value cannot be cleared and `null` is rejected. Must be a complete RFC 3339 timestamp no more than 1 minute in the future. Accepted under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` send `external_user_details.onboarded_at` instead.
12171217
12181218 format: date-time
12191219
from line 1245
12451245
12461246 - `created_at: string`
12471247
1248 A timestamp in RFC 3339 format
1248 When this user profile was created, in RFC 3339 format.
12491249
12501250 format: date-time
12511251
from line 1269
12691269
12701270 - `updated_at: string`
12711271
1272 A timestamp in RFC 3339 format
1272 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
12731273
12741274 format: date-time
12751275
12761276 - `access_type: optional "application" or "passthrough"`
12771277
1278 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
1278 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
12791279
12801280 - `"application"`
12811281
from line 1291
12911291
12921292 - `external_user_details: optional BetaUserProfileExternalUserDetails`
12931293
1294 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
1294 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
12951295
12961296 - `account_status: "active" or "suspended" or "blocked" or null`
12971297
1298 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
1298 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
12991299
13001300 - `"active"`
13011301
from line 1319
13191319
13201320 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
13211321
1322 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
1322 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
13231323
13241324 - `"individual"`
13251325
from line 1335
13351335
13361336 - `onboarded_at: string or null`
13371337
1338 A timestamp in RFC 3339 format
1338 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
13391339
13401340 format: date-time
13411341
from line 1345
13451345
13461346 - `external_user_onboarded_at: optional string or null`
13471347
1348 A timestamp in RFC 3339 format
1348 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
13491349
13501350 format: date-time
13511351
from line 1532
15321532
15331533 - `expires_at: string`
15341534
1535 A timestamp in RFC 3339 format
1535 When this enrollment URL expires, in RFC 3339 format.
15361536
15371537 format: date-time
15381538
from line 1580
15801580
15811581 - `created_at: string`
15821582
1583 A timestamp in RFC 3339 format
1583 When this user profile was created, in RFC 3339 format.
15841584
15851585 format: date-time
15861586
from line 1604
16041604
16051605 - `updated_at: string`
16061606
1607 A timestamp in RFC 3339 format
1607 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
16081608
16091609 format: date-time
16101610
16111611 - `access_type: optional "application" or "passthrough"`
16121612
1613 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
1613 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
16141614
16151615 - `"application"`
16161616
from line 1626
16261626
16271627 - `external_user_details: optional BetaUserProfileExternalUserDetails`
16281628
1629 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
1629 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
16301630
16311631 - `account_status: "active" or "suspended" or "blocked" or null`
16321632
1633 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
1633 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
16341634
16351635 - `"active"`
16361636
from line 1654
16541654
16551655 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
16561656
1657 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
1657 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
16581658
16591659 - `"individual"`
16601660
from line 1670
16701670
16711671 - `onboarded_at: string or null`
16721672
1673 A timestamp in RFC 3339 format
1673 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
16741674
16751675 format: date-time
16761676
from line 1680
16801680
16811681 - `external_user_onboarded_at: optional string or null`
16821682
1683 A timestamp in RFC 3339 format
1683 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
16841684
16851685 format: date-time
16861686
from line 1700
17001700
17011701 - `expires_at: string`
17021702
1703 A timestamp in RFC 3339 format
1703 When this enrollment URL expires, in RFC 3339 format.
17041704
17051705 format: date-time
17061706
from line 1716
17161716
17171717 - `account_status: "active" or "suspended" or "blocked" or null`
17181718
1719 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
1719 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
17201720
17211721 - `"active"`
17221722
from line 1740
17401740
17411741 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
17421742
1743 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
1743 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
17441744
17451745 - `"individual"`
17461746
from line 1756
17561756
17571757 - `onboarded_at: string or null`
17581758
1759 A timestamp in RFC 3339 format
1759 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
17601760
17611761 format: date-time
17621762
from line 1770
17701770
17711771 - `account_status: optional "active" or "suspended" or "blocked" or null`
17721772
1773 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
1773 The status of the entity's account on the platform: `active`, `suspended` or `blocked`.
17741774
17751775 - `"active"`
17761776
from line 1796
17961796
17971797 - `entity_type: optional "individual" or "business" or "non_profit" or "government" or null`
17981798
1799 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
1799 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`.
18001800
18011801 - `"individual"`
18021802
from line 1814
18141814
18151815 - `onboarded_at: optional string`
18161816
1817 A timestamp in RFC 3339 format
1817 When the entity opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.
18181818
18191819 format: date-time
18201820
api/beta/user_profiles/create Changed · +13 / -13 lines
from line 125
125125
126126- `access_type: optional "application" or "passthrough"`
127127
128 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
128 How the platform uses the API for this entity. `application` (default): the profile represents an individual end-user of the platform's product. `passthrough`: the profile identifies a company the platform resells Claude access to.
129129
130130 - `"application"`
131131
from line 147
147147
148148 - `account_status: optional "active" or "suspended" or "blocked" or null`
149149
150 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
150 The status of the entity's account on the platform: `active`, `suspended` or `blocked`.
151151
152152 - `"active"`
153153
from line 173
173173
174174 - `entity_type: optional "individual" or "business" or "non_profit" or "government" or null`
175175
176 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
176 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`.
177177
178178 - `"individual"`
179179
from line 191
191191
192192 - `onboarded_at: optional string`
193193
194 A timestamp in RFC 3339 format
194 When the entity opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.
195195
196196 format: date-time
197197
from line 203
203203
204204- `external_user_onboarded_at: optional string`
205205
206 A timestamp in RFC 3339 format
206 When the entity this profile represents opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future. Optional. Accepted under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` send `external_user_details.onboarded_at` instead.
207207
208208 format: date-time
209209
from line 235
235235
236236 - `created_at: string`
237237
238 A timestamp in RFC 3339 format
238 When this user profile was created, in RFC 3339 format.
239239
240240 format: date-time
241241
from line 259
259259
260260 - `updated_at: string`
261261
262 A timestamp in RFC 3339 format
262 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
263263
264264 format: date-time
265265
266266 - `access_type: optional "application" or "passthrough"`
267267
268 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
268 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
269269
270270 - `"application"`
271271
from line 281
281281
282282 - `external_user_details: optional BetaUserProfileExternalUserDetails`
283283
284 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
284 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
285285
286286 - `account_status: "active" or "suspended" or "blocked" or null`
287287
288 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
288 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
289289
290290 - `"active"`
291291
from line 309
309309
310310 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
311311
312 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
312 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
313313
314314 - `"individual"`
315315
from line 325
325325
326326 - `onboarded_at: string or null`
327327
328 A timestamp in RFC 3339 format
328 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
329329
330330 format: date-time
331331
from line 335
335335
336336 - `external_user_onboarded_at: optional string or null`
337337
338 A timestamp in RFC 3339 format
338 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
339339
340340 format: date-time
341341
api/beta/user_profiles/list Changed · +8 / -8 lines
from line 175
175175
176176 - `created_at: string`
177177
178 A timestamp in RFC 3339 format
178 When this user profile was created, in RFC 3339 format.
179179
180180 format: date-time
181181
from line 199
199199
200200 - `updated_at: string`
201201
202 A timestamp in RFC 3339 format
202 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
203203
204204 format: date-time
205205
206206 - `access_type: optional "application" or "passthrough"`
207207
208 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
208 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
209209
210210 - `"application"`
211211
from line 221
221221
222222 - `external_user_details: optional BetaUserProfileExternalUserDetails`
223223
224 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
224 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
225225
226226 - `account_status: "active" or "suspended" or "blocked" or null`
227227
228 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
228 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
229229
230230 - `"active"`
231231
from line 249
249249
250250 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
251251
252 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
252 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
253253
254254 - `"individual"`
255255
from line 265
265265
266266 - `onboarded_at: string or null`
267267
268 A timestamp in RFC 3339 format
268 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
269269
270270 format: date-time
271271
from line 275
275275
276276 - `external_user_onboarded_at: optional string or null`
277277
278 A timestamp in RFC 3339 format
278 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
279279
280280 format: date-time
281281
api/beta/user_profiles/retrieve Changed · +8 / -8 lines
from line 145
145145
146146 - `created_at: string`
147147
148 A timestamp in RFC 3339 format
148 When this user profile was created, in RFC 3339 format.
149149
150150 format: date-time
151151
from line 169
169169
170170 - `updated_at: string`
171171
172 A timestamp in RFC 3339 format
172 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
173173
174174 format: date-time
175175
176176 - `access_type: optional "application" or "passthrough"`
177177
178 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
178 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
179179
180180 - `"application"`
181181
from line 191
191191
192192 - `external_user_details: optional BetaUserProfileExternalUserDetails`
193193
194 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
194 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
195195
196196 - `account_status: "active" or "suspended" or "blocked" or null`
197197
198 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
198 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
199199
200200 - `"active"`
201201
from line 219
219219
220220 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
221221
222 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
222 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
223223
224224 - `"individual"`
225225
from line 235
235235
236236 - `onboarded_at: string or null`
237237
238 A timestamp in RFC 3339 format
238 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
239239
240240 format: date-time
241241
from line 245
245245
246246 - `external_user_onboarded_at: optional string or null`
247247
248 A timestamp in RFC 3339 format
248 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
249249
250250 format: date-time
251251
api/beta/user_profiles/update Changed · +13 / -13 lines
from line 131
131131
132132- `access_type: optional "application" or "passthrough" or null`
133133
134 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
134 If present, replaces the stored access type. Omit to leave unchanged.
135135
136136 - `"application"`
137137
from line 153
153153
154154 - `account_status: optional "active" or "suspended" or "blocked" or null`
155155
156 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
156 The status of the entity's account on the platform: `active`, `suspended` or `blocked`.
157157
158158 - `"active"`
159159
from line 179
179179
180180 - `entity_type: optional "individual" or "business" or "non_profit" or "government" or null`
181181
182 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
182 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`.
183183
184184 - `"individual"`
185185
from line 197
197197
198198 - `onboarded_at: optional string`
199199
200 A timestamp in RFC 3339 format
200 When the entity opened its account with the platform, in RFC 3339 format: for an `application` profile, when the end-user signed up; for a `passthrough` profile, when the company became the platform's customer. Must be a complete timestamp no more than 1 minute in the future.
201201
202202 format: date-time
203203
from line 209
209209
210210- `external_user_onboarded_at: optional string`
211211
212 A timestamp in RFC 3339 format
212 If present, replaces the stored account creation time. Omit to leave unchanged; once set, the value cannot be cleared and `null` is rejected. Must be a complete RFC 3339 timestamp no more than 1 minute in the future. Accepted under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` send `external_user_details.onboarded_at` instead.
213213
214214 format: date-time
215215
from line 241
241241
242242 - `created_at: string`
243243
244 A timestamp in RFC 3339 format
244 When this user profile was created, in RFC 3339 format.
245245
246246 format: date-time
247247
from line 265
265265
266266 - `updated_at: string`
267267
268 A timestamp in RFC 3339 format
268 When this user profile was last modified, in RFC 3339 format. Trust-grant status changes also bump this timestamp.
269269
270270 format: date-time
271271
272272 - `access_type: optional "application" or "passthrough"`
273273
274 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
274 How the platform uses the API for this entity: `application` (default) or `passthrough`. Present under the `user-profiles-2026-08-18` and later beta headers.
275275
276276 - `"application"`
277277
from line 287
287287
288288 - `external_user_details: optional BetaUserProfileExternalUserDetails`
289289
290 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
290 Details about the entity this profile represents, as the platform states them; not verified by Anthropic. Present under the `user-profiles-2026-09-04` beta header, with every field present and `null` until the platform supplies a value; the earlier beta headers serve `reference_id` as the top-level `external_id`, and `user-profiles-2026-08-18` serves `onboarded_at` as `external_user_onboarded_at`.
291291
292292 - `account_status: "active" or "suspended" or "blocked" or null`
293293
294 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
294 The status of the entity's account on the platform: `active`, `suspended` or `blocked`. `null` until the platform supplies one.
295295
296296 - `"active"`
297297
from line 315
315315
316316 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
317317
318 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
318 What kind of entity the profile represents: `individual`, `business`, `non_profit` or `government`. `null` until the platform supplies one.
319319
320320 - `"individual"`
321321
from line 331
331331
332332 - `onboarded_at: string or null`
333333
334 A timestamp in RFC 3339 format
334 When the entity opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one.
335335
336336 format: date-time
337337
from line 341
341341
342342 - `external_user_onboarded_at: optional string or null`
343343
344 A timestamp in RFC 3339 format
344 When the entity this profile represents opened its account with the platform, as stated by the platform, in RFC 3339 format (UTC). `null` until the platform supplies one. Present under the `user-profiles-2026-08-18` beta header; under `user-profiles-2026-09-04` the value is `external_user_details.onboarded_at`.
345345
346346 format: date-time
347347
api/beta/vaults Changed · +358 / -358 lines
from line 149
149149
150150 - `archived_at: string or null`
151151
152 A timestamp in RFC 3339 format
152 When the vault was archived. Null if not archived.
153153
154154 format: date-time
155155
from line 353
353353
354354 - `archived_at: string or null`
355355
356 A timestamp in RFC 3339 format
356 When the vault was archived. Null if not archived.
357357
358358 format: date-time
359359
from line 549
549549
550550 - `archived_at: string or null`
551551
552 A timestamp in RFC 3339 format
552 When the vault was archived. Null if not archived.
553553
554554 format: date-time
555555
from line 748
748748
749749 - `archived_at: string or null`
750750
751 A timestamp in RFC 3339 format
751 When the vault was archived. Null if not archived.
752752
753753 format: date-time
754754
from line 1097
10971097
10981098 - `archived_at: string or null`
10991099
1100 A timestamp in RFC 3339 format
1100 When the vault was archived. Null if not archived.
11011101
11021102 format: date-time
11031103
from line 1175
11751175
11761176 - `archived_at: string or null`
11771177
1178 A timestamp in RFC 3339 format
1178 When the vault was archived. Null if not archived.
11791179
11801180 format: date-time
11811181
from line 1329
13291329
13301330- `auth: BetaManagedAgentsMCPOAuthCreateParams or BetaManagedAgentsStaticBearerCreateParams or BetaManagedAgentsEnvironmentVariableCreateParams`
13311331
1332 Authentication details for creating a credential.
1332 Authentication configuration for the credential.
13331333
13341334 - `BetaManagedAgentsMCPOAuthCreateParams object`
13351335
from line 1357
13571357
13581358 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshParams or null`
13591359
1360 OAuth refresh token parameters for creating a credential with refresh support.
1360 Refresh token configuration, if the credential supports token refresh.
13611361
13621362 - `client_id: string`
13631363
from line 1513
15131513
15141514 - `archived_at: string or null`
15151515
1516 A timestamp in RFC 3339 format
1516 When the credential was archived. Null if not archived.
15171517
15181518 format: date-time
15191519
15201520 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
15211521
1522 Authentication details for a credential.
1522 Authentication configuration for this credential.
15231523
15241524 - `BetaManagedAgentsMCPOAuthAuthResponse object`
15251525
from line 1539
15391539
15401540 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
15411541
1542 OAuth refresh token configuration returned in credential responses.
1542 Refresh token configuration, if the credential supports token refresh.
15431543
15441544 - `client_id: string`
15451545
from line 1849
18491849
18501850 - `archived_at: string or null`
18511851
1852 A timestamp in RFC 3339 format
1852 When the credential was archived. Null if not archived.
18531853
18541854 format: date-time
18551855
18561856 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
18571857
1858 Authentication details for a credential.
1858 Authentication configuration for this credential.
18591859
18601860 - `BetaManagedAgentsMCPOAuthAuthResponse object`
18611861
from line 1875
18751875
18761876 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
18771877
1878 OAuth refresh token configuration returned in credential responses.
1878 Refresh token configuration, if the credential supports token refresh.
18791879
18801880 - `client_id: string`
18811881
from line 2170
21702170
21712171 - `archived_at: string or null`
21722172
2173 A timestamp in RFC 3339 format
2173 When the credential was archived. Null if not archived.
21742174
21752175 format: date-time
21762176
21772177 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
21782178
2179 Authentication details for a credential.
2179 Authentication configuration for this credential.
21802180
21812181 - `BetaManagedAgentsMCPOAuthAuthResponse object`
21822182
from line 2196
21962196
21972197 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
21982198
2199 OAuth refresh token configuration returned in credential responses.
2199 Refresh token configuration, if the credential supports token refresh.
22002200
22012201 - `client_id: string`
22022202
from line 2472
24722472
24732473- `auth: optional BetaManagedAgentsMCPOAuthUpdateParams or BetaManagedAgentsStaticBearerUpdateParams or BetaManagedAgentsEnvironmentVariableUpdateParams`
24742474
2475 Updated authentication details for a credential.
2475 Updated authentication configuration. The `type` is immutable; the variant sent must match the stored credential's type.
24762476
24772477 - `BetaManagedAgentsMCPOAuthUpdateParams object`
24782478
from line 2494
24942494
24952495 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshUpdateParams or null`
24962496
2497 Parameters for updating OAuth refresh token configuration.
2497 Updated refresh token configuration.
24982498
24992499 - `refresh_token: optional string or null`
25002500
from line 2614
26142614
26152615 - `archived_at: string or null`
26162616
2617 A timestamp in RFC 3339 format
2617 When the credential was archived. Null if not archived.
26182618
26192619 format: date-time
26202620
26212621 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
26222622
2623 Authentication details for a credential.
2623 Authentication configuration for this credential.
26242624
26252625 - `BetaManagedAgentsMCPOAuthAuthResponse object`
26262626
from line 2640
26402640
26412641 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
26422642
2643 OAuth refresh token configuration returned in credential responses.
2643 Refresh token configuration, if the credential supports token refresh.
26442644
26452645 - `client_id: string`
26462646
from line 3092
30923092
30933093 - `archived_at: string or null`
30943094
3095 A timestamp in RFC 3339 format
3095 When the credential was archived. Null if not archived.
30963096
30973097 format: date-time
30983098
30993099 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
31003100
3101 Authentication details for a credential.
3101 Authentication configuration for this credential.
31023102
31033103 - `BetaManagedAgentsMCPOAuthAuthResponse object`
31043104
from line 3118
31183118
31193119 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
31203120
3121 OAuth refresh token configuration returned in credential responses.
3121 Refresh token configuration, if the credential supports token refresh.
31223122
31233123 - `client_id: string`
31243124
from line 3409
34093409
34103410 - `mcp_probe: BetaManagedAgentsMCPProbe or null`
34113411
3412 The failing step of an MCP validation probe.
3412 Details of the failing MCP probe step. Null when the probe succeeded.
34133413
34143414 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
34153415
3416 An HTTP response captured during a credential validation probe.
3416 The captured HTTP error response. Null when no HTTP response was received (timeout, DNS, TLS).
34173417
34183418 - `body: string`
34193419
from line 3439
34393439
34403440 - `refresh: BetaManagedAgentsRefreshObject or null`
34413441
3442 Outcome of a refresh-token exchange attempted during credential validation.
3442 Details of the refresh-token exchange attempted on a 401. Null when no refresh was attempted.
34433443
34443444 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
34453445
3446 An HTTP response captured during a credential validation probe.
3446 The captured HTTP error response from the token endpoint. Populated only when `status` is `failed`.
34473447
34483448 - `status: "succeeded" or "failed" or "connect_error" or "no_refresh_token"`
34493449
3450 Outcome of a refresh-token exchange attempted during credential validation.
3450 Outcome of the refresh attempt.
34513451
34523452 - `"succeeded"`
34533453
from line 3467
34673467
34683468 - `status: BetaManagedAgentsCredentialValidationStatus`
34693469
3470 Overall verdict of a credential validation probe.
3470 Overall verdict of the validation probe.
34713471
34723472 - `"valid"`
34733473
from line 3483
34833483
34843484 - `validated_at: string`
34853485
3486 A timestamp in RFC 3339 format
3486 When the validation probe was performed.
34873487
34883488 format: date-time
34893489
api/beta/vaults/credentials Changed · +1002 / -1002 lines
from line 133
133133
134134- `auth: BetaManagedAgentsMCPOAuthCreateParams or BetaManagedAgentsStaticBearerCreateParams or BetaManagedAgentsEnvironmentVariableCreateParams`
135135
136 Authentication details for creating a credential.
136 Authentication configuration for the credential.
137137
138138 - `BetaManagedAgentsMCPOAuthCreateParams object`
139139
from line 161
161161
162162 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshParams or null`
163163
164 OAuth refresh token parameters for creating a credential with refresh support.
164 Refresh token configuration, if the credential supports token refresh.
165165
166166 - `client_id: string`
167167
from line 317
317317
318318 - `archived_at: string or null`
319319
320 A timestamp in RFC 3339 format
320 When the credential was archived. Null if not archived.
321321
322322 format: date-time
323323
324324 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
325325
326 Authentication details for a credential.
326 Authentication configuration for this credential.
327327
328328 - `BetaManagedAgentsMCPOAuthAuthResponse object`
329329
from line 343
343343
344344 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
345345
346 OAuth refresh token configuration returned in credential responses.
346 Refresh token configuration, if the credential supports token refresh.
347347
348348 - `client_id: string`
349349
from line 653
653653
654654 - `archived_at: string or null`
655655
656 A timestamp in RFC 3339 format
656 When the credential was archived. Null if not archived.
657657
658658 format: date-time
659659
660660 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
661661
662 Authentication details for a credential.
662 Authentication configuration for this credential.
663663
664664 - `BetaManagedAgentsMCPOAuthAuthResponse object`
665665
from line 679
679679
680680 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
681681
682 OAuth refresh token configuration returned in credential responses.
682 Refresh token configuration, if the credential supports token refresh.
683683
684684 - `client_id: string`
685685
from line 974
974974
975975 - `archived_at: string or null`
976976
977 A timestamp in RFC 3339 format
977 When the credential was archived. Null if not archived.
978978
979979 format: date-time
980980
981981 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
982982
983 Authentication details for a credential.
983 Authentication configuration for this credential.
984984
985985 - `BetaManagedAgentsMCPOAuthAuthResponse object`
986986
from line 1000
10001000
10011001 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
10021002
1003 OAuth refresh token configuration returned in credential responses.
1003 Refresh token configuration, if the credential supports token refresh.
10041004
10051005 - `client_id: string`
10061006
from line 1276
12761276
12771277- `auth: optional BetaManagedAgentsMCPOAuthUpdateParams or BetaManagedAgentsStaticBearerUpdateParams or BetaManagedAgentsEnvironmentVariableUpdateParams`
12781278
1279 Updated authentication details for a credential.
1279 Updated authentication configuration. The `type` is immutable; the variant sent must match the stored credential's type.
12801280
12811281 - `BetaManagedAgentsMCPOAuthUpdateParams object`
12821282
from line 1298
12981298
12991299 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshUpdateParams or null`
13001300
1301 Parameters for updating OAuth refresh token configuration.
1301 Updated refresh token configuration.
13021302
13031303 - `refresh_token: optional string or null`
13041304
from line 1418
14181418
14191419 - `archived_at: string or null`
14201420
1421 A timestamp in RFC 3339 format
1421 When the credential was archived. Null if not archived.
14221422
14231423 format: date-time
14241424
14251425 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
14261426
1427 Authentication details for a credential.
1427 Authentication configuration for this credential.
14281428
14291429 - `BetaManagedAgentsMCPOAuthAuthResponse object`
14301430
from line 1444
14441444
14451445 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
14461446
1447 OAuth refresh token configuration returned in credential responses.
1447 Refresh token configuration, if the credential supports token refresh.
14481448
14491449 - `client_id: string`
14501450
from line 1896
18961896
18971897 - `archived_at: string or null`
18981898
1899 A timestamp in RFC 3339 format
1899 When the credential was archived. Null if not archived.
19001900
19011901 format: date-time
19021902
19031903 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
19041904
1905 Authentication details for a credential.
1905 Authentication configuration for this credential.
19061906
19071907 - `BetaManagedAgentsMCPOAuthAuthResponse object`
19081908
from line 1922
19221922
19231923 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
19241924
1925 OAuth refresh token configuration returned in credential responses.
1925 Refresh token configuration, if the credential supports token refresh.
19261926
19271927 - `client_id: string`
19281928
from line 2213
22132213
22142214 - `mcp_probe: BetaManagedAgentsMCPProbe or null`
22152215
2216 The failing step of an MCP validation probe.
2216 Details of the failing MCP probe step. Null when the probe succeeded.
22172217
22182218 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
22192219
2220 An HTTP response captured during a credential validation probe.
2220 The captured HTTP error response. Null when no HTTP response was received (timeout, DNS, TLS).
22212221
22222222 - `body: string`
22232223
from line 2243
22432243
22442244 - `refresh: BetaManagedAgentsRefreshObject or null`
22452245
2246 Outcome of a refresh-token exchange attempted during credential validation.
2246 Details of the refresh-token exchange attempted on a 401. Null when no refresh was attempted.
22472247
22482248 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
22492249
2250 An HTTP response captured during a credential validation probe.
2250 The captured HTTP error response from the token endpoint. Populated only when `status` is `failed`.
22512251
22522252 - `status: "succeeded" or "failed" or "connect_error" or "no_refresh_token"`
22532253
2254 Outcome of a refresh-token exchange attempted during credential validation.
2254 Outcome of the refresh attempt.
22552255
22562256 - `"succeeded"`
22572257
from line 2271
22712271
22722272 - `status: BetaManagedAgentsCredentialValidationStatus`
22732273
2274 Overall verdict of a credential validation probe.
2274 Overall verdict of the validation probe.
22752275
22762276 - `"valid"`
22772277
from line 2287
22872287
22882288 - `validated_at: string`
22892289
2290 A timestamp in RFC 3339 format
2290 When the validation probe was performed.
22912291
22922292 format: date-time
22932293
from line 2352
23522352
23532353 - `archived_at: string or null`
23542354
2355 A timestamp in RFC 3339 format
2355 When the credential was archived. Null if not archived.
23562356
23572357 format: date-time
23582358
23592359 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
23602360
2361 Authentication details for a credential.
2361 Authentication configuration for this credential.
23622362
23632363 - `BetaManagedAgentsMCPOAuthAuthResponse object`
23642364
from line 2378
23782378
23792379 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
23802380
2381 OAuth refresh token configuration returned in credential responses.
2381 Refresh token configuration, if the credential supports token refresh.
23822382
23832383 - `client_id: string`
23842384
from line 2530
25302530
25312531 - `mcp_probe: BetaManagedAgentsMCPProbe or null`
25322532
2533 The failing step of an MCP validation probe.
2533 Details of the failing MCP probe step. Null when the probe succeeded.
25342534
25352535 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
25362536
2537 An HTTP response captured during a credential validation probe.
2537 The captured HTTP error response. Null when no HTTP response was received (timeout, DNS, TLS).
25382538
25392539 - `body: string`
25402540
from line 2560
25602560
25612561 - `refresh: BetaManagedAgentsRefreshObject or null`
25622562
2563 Outcome of a refresh-token exchange attempted during credential validation.
2563 Details of the refresh-token exchange attempted on a 401. Null when no refresh was attempted.
25642564
25652565 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
25662566
2567 An HTTP response captured during a credential validation probe.
2567 The captured HTTP error response from the token endpoint. Populated only when `status` is `failed`.
25682568
25692569 - `status: "succeeded" or "failed" or "connect_error" or "no_refresh_token"`
25702570
2571 Outcome of a refresh-token exchange attempted during credential validation.
2571 Outcome of the refresh attempt.
25722572
25732573 - `"succeeded"`
25742574
from line 2588
25882588
25892589 - `status: BetaManagedAgentsCredentialValidationStatus`
25902590
2591 Overall verdict of a credential validation probe.
2591 Overall verdict of the validation probe.
25922592
25932593 - `"valid"`
25942594
from line 2604
26042604
26052605 - `validated_at: string`
26062606
2607 A timestamp in RFC 3339 format
2607 When the validation probe was performed.
26082608
26092609 format: date-time
26102610
from line 2870
28702870
28712871 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
28722872
2873 OAuth refresh token configuration returned in credential responses.
2873 Refresh token configuration, if the credential supports token refresh.
28742874
28752875 - `client_id: string`
28762876
from line 2936
29362936
29372937 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshParams or null`
29382938
2939 OAuth refresh token parameters for creating a credential with refresh support.
2939 Refresh token configuration, if the credential supports token refresh.
29402940
29412941 - `client_id: string`
29422942
from line 3176
31763176
31773177 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshUpdateParams or null`
31783178
3179 Parameters for updating OAuth refresh token configuration.
3179 Updated refresh token configuration.
31803180
31813181 - `refresh_token: optional string or null`
31823182
from line 3224
32243224
32253225 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
32263226
3227 An HTTP response captured during a credential validation probe.
3227 The captured HTTP error response. Null when no HTTP response was received (timeout, DNS, TLS).
32283228
32293229 - `body: string`
32303230
from line 3280
32803280
32813281 - `http_response: BetaManagedAgentsRefreshHTTPResponse or null`
32823282
3283 An HTTP response captured during a credential validation probe.
3283 The captured HTTP error response from the token endpoint. Populated only when `status` is `failed`.
32843284
32853285 - `body: string`
32863286
from line 3302
33023302
33033303 - `status: "succeeded" or "failed" or "connect_error" or "no_refresh_token"`
33043304
3305 Outcome of a refresh-token exchange attempted during credential validation.
3305 Outcome of the refresh attempt.
33063306
33073307 - `"succeeded"`
33083308
api/beta/vaults/credentials/archive Changed · +3 / -3 lines
from line 145
145145
146146 - `archived_at: string or null`
147147
148 A timestamp in RFC 3339 format
148 When the credential was archived. Null if not archived.
149149
150150 format: date-time
151151
152152 - `auth: BetaManagedAgentsMCPOAuthAuthResponse or BetaManagedAgentsStaticBearerAuthResponse or BetaManagedAgentsEnvironmentVariableAuthResponse`
153153
154 Authentication details for a credential.
154 Authentication configuration for this credential.
155155
156156 - `BetaManagedAgentsMCPOAuthAuthResponse object`
157157
from line 171
171171
172172 - `refresh: optional BetaManagedAgentsMCPOAuthRefreshResponse or null`
173173
174 OAuth refresh token configuration returned in credential responses.
174 Refresh token configuration, if the credential supports token refresh.
175175
176176 - `client_id: string`
177177