Agents changedapi/beta/agents
Nearest release: v2.1.296, published 4 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+3,367added
Lines−1,489removed
From line
185
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to this page, all time
### Beta Managed Agents Multiagent Advisor ### Beta Managed Agents Multiagent Advisor Disabled ### Beta Managed Agents Multiagent Advisor Disabled Params ### Beta Managed Agents Multiagent Advisor Enabled ### Beta Managed Agents Multiagent Advisor Enabled Params ### Beta Managed Agents Multiagent Advisor Params ### Beta Managed Agents Multiagent Inline Agents ### Beta Managed Agents Multiagent Inline Agents Disabled ### Beta Managed Agents Multiagent Inline Agents Disabled Params ### Beta Managed Agents Multiagent Inline Agents Enabled ### Beta Managed Agents Multiagent Inline Agents Enabled Params ### Beta Managed Agents Multiagent Inline Agents Params ### Beta Managed Agents Multiagent Predefined Agent Params ### Beta Managed Agents Multiagent Subagents ### Beta Managed Agents Multiagent Subagents Disabled ### Beta Managed Agents Multiagent Subagents Disabled Params ### Beta Managed Agents Multiagent Subagents Enabled ### Beta Managed Agents Multiagent Subagents Enabled Params ### Beta Managed Agents Multiagent Subagents Params ### Beta Managed Agents Multiagent Workflows ### Beta Managed Agents Multiagent Workflows Disabled ### Beta Managed Agents Multiagent Workflows Disabled Params ### Beta Managed Agents Multiagent Workflows Enabled ### Beta Managed Agents Multiagent Workflows Enabled Params ### Beta Managed Agents Multiagent Workflows Params ### Beta Managed Agents Multiagent20261001 ### Beta Managed Agents Multiagent20261001 Params
The whole hunk
from line 185, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 185
185185
186186 - `"claude-haiku-4-5"`
187187
188 Fastest model with near-frontier intelligence
189
190188 - `"claude-haiku-4-5-20251001"`
191189
192 Fastest model with near-frontier intelligence
193
194190 - `"claude-opus-4-5"`
195191
196192 Powerful intelligence for long-running agents and coding
from line 323
327323
328324 Multiagent orchestration configuration.
329325
330 - `type: "coordinator"`
331
332 - `agents: array of BetaManagedAgentsMultiagentRosterEntryParams`
333
334 Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1).
335
336 - `string`
337
338 - `BetaManagedAgentsAgentParams object`
339
340 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
341
342 - `type: "agent"`
343
344 - `id: string`
345
346 The `agent` ID.
326 - `BetaManagedAgentsMultiagentCoordinatorParams object`
327
328 A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.
329
330 - `type: "coordinator"`
331
332 - `agents: array of BetaManagedAgentsMultiagentRosterEntryParams`
333
334 Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1).
335
336 - `string`
337
338 - `BetaManagedAgentsAgentParams object`
339
340 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
341
342 - `type: "agent"`
343
344 - `id: string`
345
346 The `agent` ID.
347
348 minLength: 1, maxLength: 128
349
350 - `version: optional number`
351
352 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
353
354 format: int32
355
356 - `BetaManagedAgentsMultiagentSelfParams object`
357
358 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
359
360 - `type: "self"`
361
362 - `BetaManagedAgentsAdvisorParams object`
363
364 Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.
365
366 - `type: "advisor"`
367
368 - `model: string`
369
370 A Claude model id. The model must be permitted as an advisor for this agent's model.
371
372 minLength: 1, maxLength: 256
373
374 - `BetaManagedAgentsMultiagent20261001Params object`
375
376 Multiagent configuration with three members, each enabled or disabled on its own. On an update, if the agent's stored `multiagent` also has type `multiagent_20261001`, this configuration is merged into the stored one, level by level, instead of replacing it. A key that the update omits keeps its stored value. A key sent as null takes its default, on create as well, so `"workflows": null` enables workflows. An object sent with a `type` other than the stored one replaces the stored object, and the keys that it omits take their defaults. A `predefined_agents` list that is sent replaces the stored list. Every object that is sent needs its `type`, and an enabled `advisor` needs its `model`. Other validation applies to the merged result.
377
378 - `type: "multiagent_20261001"`
379
380 - `advisor: optional BetaManagedAgentsMultiagentAdvisorParams or null`
381
382 Whether the session's primary thread can consult an advisor model. Defaults to disabled.
383
384 - `BetaManagedAgentsMultiagentAdvisorEnabledParams object`
385
386 The session's primary thread can consult `model` mid-turn.
387
388 - `type: "enabled"`
389
390 - `model: string`
391
392 A Claude model id. The model must be permitted as an advisor for this agent's model.
393
394 minLength: 1, maxLength: 256
395
396 - `BetaManagedAgentsMultiagentAdvisorDisabledParams object`
397
398 The agent has no advisor.
399
400 - `type: "disabled"`
401
402 - `subagents: optional BetaManagedAgentsMultiagentSubagentsParams or null`
403
404 Whether the agent can spawn session threads. Defaults to enabled.
405
406 - `BetaManagedAgentsMultiagentSubagentsEnabledParams object`
407
408 The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
409
410 - `type: "enabled"`
411
412 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
413
414 Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.
415
416 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
417
418 The agent can define inline agents.
419
420 - `type: "enabled"`
421
422 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
423
424 The agent cannot define inline agents.
425
426 - `type: "disabled"`
427
428 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
429
430 Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other.
431
432 - `string`
433
434 - `BetaManagedAgentsAgentParams object`
435
436 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
437
438 - `BetaManagedAgentsMultiagentSelfParams object`
439
440 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
441
442 - `BetaManagedAgentsMultiagentSubagentsDisabledParams object`
443
444 The agent cannot spawn session threads.
445
446 - `type: "disabled"`
447
448 - `workflows: optional BetaManagedAgentsMultiagentWorkflowsParams or null`
449
450 Whether the agent can start workflow runs. Defaults to enabled.
451
452 - `BetaManagedAgentsMultiagentWorkflowsEnabledParams object`
453
454 The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
455
456 - `type: "enabled"`
457
458 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
459
460 Whether a run's plan can define inline agents. Defaults to enabled.
461
462 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
463
464 Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other.
465
466 - `string`
467
468 - `BetaManagedAgentsAgentParams object`
469
470 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
471
472 - `BetaManagedAgentsMultiagentSelfParams object`
473
474 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
475
476 - `BetaManagedAgentsMultiagentWorkflowsDisabledParams object`
477
478 The agent cannot start workflow runs.
479
480 - `type: "disabled"`
481
482- `skills: optional array of BetaManagedAgentsSkillParams`
483
484 Skills available to the agent.
485
486 - `BetaManagedAgentsAnthropicSkillParams object`
487
488 An Anthropic-managed skill.
489
490 - `type: "anthropic"`
491
492 - `skill_id: string`
493
494 Identifier of the Anthropic skill (e.g., "xlsx").
495
496 minLength: 1, maxLength: 64
497
498 - `version: optional string or null`
499
500 Version to pin. Defaults to latest if omitted.
501
502 minLength: 1, maxLength: 64
503
504 - `BetaManagedAgentsCustomSkillParams object`
505
506 A user-created custom skill.
507
508 - `type: "custom"`
509
510 - `skill_id: string`
511
512 Tagged ID of the custom skill (e.g., "skill_01XJ5...").
513
514 minLength: 1, maxLength: 64
515
516 - `version: optional string or null`
517
518 Version to pin. Defaults to latest if omitted.
519
520 minLength: 1, maxLength: 64
521
522- `system: optional string or null`
523
524 System prompt for the agent.
525
526 maxLength: 100000
527
528- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams`
529
530 Tool configurations available to the agent. Maximum of 256 tools across all toolsets allowed.
531
532 - `BetaManagedAgentsAgentToolset20260401Params object`
533
534 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
535
536 - `type: "agent_toolset_20260401"`
537
538 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
539
540 Per-tool configuration overrides.
541
542 - `BetaManagedAgentsBashToolConfigParams object`
543
544 Configuration override for the bash tool.
545
546 - `type: optional "bash"`
547
548 - `name: "bash"`
549
550 Must be "bash".
551
552 - `enabled: optional boolean or null`
553
554 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
555
556 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
557
558 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
559
560 - `BetaManagedAgentsAlwaysAllowPolicy object`
561
562 Tool calls are automatically approved without user confirmation.
563
564 - `type: "always_allow"`
565
566 - `BetaManagedAgentsAlwaysAskPolicy object`
567
568 Tool calls require user confirmation before execution.
569
570 - `type: "always_ask"`
571
572 - `BetaManagedAgentsAutoPolicy object`
573
574 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
575
576 - `type: "auto"`
577
578 - `BetaManagedAgentsEditToolConfigParams object`
579
580 Configuration override for the edit tool.
581
582 - `type: optional "edit"`
583
584 - `name: "edit"`
585
586 Must be "edit".
587
588 - `enabled: optional boolean or null`
589
590 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
591
592 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
593
594 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
595
596 - `BetaManagedAgentsAlwaysAllowPolicy object`
597
598 Tool calls are automatically approved without user confirmation.
599
600 - `BetaManagedAgentsAlwaysAskPolicy object`
601
602 Tool calls require user confirmation before execution.
603
604 - `BetaManagedAgentsAutoPolicy object`
605
606 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
607
608 - `BetaManagedAgentsReadToolConfigParams object`
609
610 Configuration override for the read tool.
611
612 - `type: optional "read"`
613
614 - `name: "read"`
615
616 Must be "read".
617
618 - `enabled: optional boolean or null`
619
620 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
621
622 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
623
624 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
625
626 - `BetaManagedAgentsAlwaysAllowPolicy object`
627
628 Tool calls are automatically approved without user confirmation.
629
630 - `BetaManagedAgentsAlwaysAskPolicy object`
631
632 Tool calls require user confirmation before execution.
633
634 - `BetaManagedAgentsAutoPolicy object`
635
636 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
637
638 - `BetaManagedAgentsWriteToolConfigParams object`
639
640 Configuration override for the write tool.
641
642 - `type: optional "write"`
643
644 - `name: "write"`
645
646 Must be "write".
647
648 - `enabled: optional boolean or null`
649
650 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
651
652 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
653
654 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
655
656 - `BetaManagedAgentsAlwaysAllowPolicy object`
657
658 Tool calls are automatically approved without user confirmation.
659
660 - `BetaManagedAgentsAlwaysAskPolicy object`
661
662 Tool calls require user confirmation before execution.
663
664 - `BetaManagedAgentsAutoPolicy object`
665
666 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
667
668 - `BetaManagedAgentsGlobToolConfigParams object`
669
670 Configuration override for the glob tool.
671
672 - `type: optional "glob"`
673
674 - `name: "glob"`
675
676 Must be "glob".
677
678 - `enabled: optional boolean or null`
679
680 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
681
682 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
683
684 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
685
686 - `BetaManagedAgentsAlwaysAllowPolicy object`
687
688 Tool calls are automatically approved without user confirmation.
689
690 - `BetaManagedAgentsAlwaysAskPolicy object`
691
692 Tool calls require user confirmation before execution.
693
694 - `BetaManagedAgentsAutoPolicy object`
695
696 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
697
698 - `BetaManagedAgentsGrepToolConfigParams object`
699
700 Configuration override for the grep tool.
701
702 - `type: optional "grep"`
703
704 - `name: "grep"`
705
706 Must be "grep".
707
708 - `enabled: optional boolean or null`
709
710 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
711
712 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
713
714 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
715
716 - `BetaManagedAgentsAlwaysAllowPolicy object`
717
718 Tool calls are automatically approved without user confirmation.
719
720 - `BetaManagedAgentsAlwaysAskPolicy object`
721
722 Tool calls require user confirmation before execution.
723
724 - `BetaManagedAgentsAutoPolicy object`
725
726 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
727
728 - `BetaManagedAgentsWebFetchToolConfigParams object`
729
730 Configuration override for the web_fetch tool.
731
732 - `type: optional "web_fetch"`
733
734 - `name: "web_fetch"`
735
736 Must be "web_fetch".
737
738 - `allowed_domains: optional array of string`
739
740 Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
741
742 - `blocked_domains: optional array of string`
743
744 Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
745
746 - `enabled: optional boolean or null`
747
748 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
749
750 - `max_content_tokens: optional number or null`
751
752 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
753
754 format: int32
755
756 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
757
758 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
759
760 - `BetaManagedAgentsAlwaysAllowPolicy object`
761
762 Tool calls are automatically approved without user confirmation.
763
764 - `BetaManagedAgentsAlwaysAskPolicy object`
765
766 Tool calls require user confirmation before execution.
767
768 - `BetaManagedAgentsAutoPolicy object`
769
770 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
771
772 - `url_sources: optional BetaManagedAgentsWebFetchURLSourcesParams or null`
773
774 Which sources contribute URLs the tool may fetch. Omit to allow every source.
775
776 - `client_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
777
778 Which custom tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be a custom tool in the same tools array.
779
780 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
781
782 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
783
784 - `"all"`
785
786 - `"none"`
787
788 - `BetaManagedAgentsWebFetchURLSourceToolFilter = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone or BetaManagedAgentsWebFetchURLSourceOnly or BetaManagedAgentsWebFetchURLSourceExcept`
789
790 Which tools' results contribute URLs that may be fetched.
791
792 - `BetaManagedAgentsWebFetchURLSourceAll object`
793
794 Every URL from this source may be fetched. This is the default.
795
796 - `type: "all"`
797
798 - `BetaManagedAgentsWebFetchURLSourceNone object`
799
800 This source contributes no URLs that may be fetched.
801
802 - `type: "none"`
803
804 - `BetaManagedAgentsWebFetchURLSourceOnly object`
805
806 Only the named tools' results contribute URLs that may be fetched.
807
808 - `type: "only"`
809
810 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
811
812 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
813
814 - `type: "tool_reference"`
815
816 Must be "tool_reference".
817
818 - `name: string`
819
820 Name of the tool. Compared exactly, so upper and lower case letters are different.
821
822 minLength: 1, maxLength: 128
823
824 - `BetaManagedAgentsWebFetchURLSourceExcept object`
825
826 Every tool's results contribute URLs that may be fetched, except the named tools' results.
827
828 - `type: "except"`
829
830 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
831
832 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
833
834 - `type: "tool_reference"`
835
836 Must be "tool_reference".
837
838 - `name: string`
839
840 Name of the tool. Compared exactly, so upper and lower case letters are different.
841
842 minLength: 1, maxLength: 128
843
844 - `server_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
845
846 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be "web_search" or "web_fetch".
847
848 - `user_input: optional BetaManagedAgentsWebFetchURLSourceUserInputParams or null`
849
850 Whether URLs in the text of user messages may be fetched: "all" (the default) or "none".
851
852 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
853
854 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
855
856 - `BetaManagedAgentsWebFetchURLSourceUserInput = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone`
857
858 Whether URLs in the text of user messages may be fetched.
859
860 - `BetaManagedAgentsWebFetchURLSourceAll object`
861
862 Every URL from this source may be fetched. This is the default.
863
864 - `BetaManagedAgentsWebFetchURLSourceNone object`
865
866 This source contributes no URLs that may be fetched.
867
868 - `BetaManagedAgentsWebSearchToolConfigParams object`
869
870 Configuration override for the web_search tool.
871
872 - `type: optional "web_search"`
873
874 - `name: "web_search"`
875
876 Must be "web_search".
877
878 - `allowed_domains: optional array of string`
879
880 Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
881
882 - `blocked_domains: optional array of string`
883
884 Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
885
886 - `enabled: optional boolean or null`
887
888 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
889
890 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
891
892 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
893
894 - `BetaManagedAgentsAlwaysAllowPolicy object`
895
896 Tool calls are automatically approved without user confirmation.
897
898 - `BetaManagedAgentsAlwaysAskPolicy object`
899
900 Tool calls require user confirmation before execution.
901
902 - `BetaManagedAgentsAutoPolicy object`
903
904 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
905
906 - `user_location: optional BetaManagedAgentsUserLocation or null`
907
908 Approximate user location for search result localization.
909
910 - `type: "approximate"`
911
912 Location precision. Only "approximate" is supported.
913
914 - `city: optional string or null`
915
916 City name.
917
918 minLength: 1, maxLength: 255
919
920 - `country: optional string or null`
921
922 Two-letter ISO 3166-1 country code, uppercase.
923
924 - `region: optional string or null`
925
926 Region or state name.
927
928 minLength: 1, maxLength: 255
929
930 - `timezone: optional string or null`
931
932 IANA timezone identifier, e.g. "America/Los_Angeles".
933
934 minLength: 1, maxLength: 255
935
936 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
937
938 Default configuration applied to all tools in this set.
939
940 - `enabled: optional boolean or null`
941
942 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
943
944 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
945
946 Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
947
948 - `BetaManagedAgentsAlwaysAllowPolicy object`
949
950 Tool calls are automatically approved without user confirmation.
951
952 - `BetaManagedAgentsAlwaysAskPolicy object`
953
954 Tool calls require user confirmation before execution.
955
956 - `BetaManagedAgentsAutoPolicy object`
957
958 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
959
960 - `BetaManagedAgentsMCPToolsetParams object`
961
962 Configuration for tools from an MCP server defined in `mcp_servers`.
963
964 - `type: "mcp_toolset"`
965
966 - `mcp_server_name: string`
967
968 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
969
970 minLength: 1, maxLength: 255
971
972 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
973
974 Per-tool configuration overrides.
975
976 - `name: string`
977
978 Name of the MCP tool to configure. 1-128 characters.
347979
348980 minLength: 1, maxLength: 128
349981
350 - `version: optional number`
351
352 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
353
354 format: int32
355
356 - `BetaManagedAgentsMultiagentSelfParams object`
357
358 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
359
360 - `type: "self"`
361
362 - `BetaManagedAgentsAdvisorParams object`
363
364 Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.
365
366 - `type: "advisor"`
367
368 - `model: string`
369
370 A Claude model id. The model must be permitted as an advisor for this agent's model.
371
372 minLength: 1, maxLength: 256
373
374- `skills: optional array of BetaManagedAgentsSkillParams`
375
376 Skills available to the agent.
377
378 - `BetaManagedAgentsAnthropicSkillParams object`
379
380 An Anthropic-managed skill.
381
382 - `type: "anthropic"`
383
384 - `skill_id: string`
385
386 Identifier of the Anthropic skill (e.g., "xlsx").
387
388 minLength: 1, maxLength: 64
389
390 - `version: optional string or null`
391
392 Version to pin. Defaults to latest if omitted.
393
394 minLength: 1, maxLength: 64
395
396 - `BetaManagedAgentsCustomSkillParams object`
397
398 A user-created custom skill.
982 - `enabled: optional boolean or null`
983
984 Whether this tool is enabled. Overrides the `default_config` setting.
985
986 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
987
988 Permission policy for this tool. Overrides the `default_config` setting.
989
990 - `BetaManagedAgentsAlwaysAllowPolicy object`
991
992 Tool calls are automatically approved without user confirmation.
993
994 - `BetaManagedAgentsAlwaysAskPolicy object`
995
996 Tool calls require user confirmation before execution.
997
998 - `BetaManagedAgentsAutoPolicy object`
999
1000 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1001
1002 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
1003
1004 Default configuration for all tools from this server.
1005
1006 - `enabled: optional boolean or null`
1007
1008 Whether tools are enabled by default. Defaults to true if not specified.
1009
1010 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
1011
1012 Default permission policy for tools from this server.
1013
1014 - `BetaManagedAgentsAlwaysAllowPolicy object`
1015
1016 Tool calls are automatically approved without user confirmation.
1017
1018 - `BetaManagedAgentsAlwaysAskPolicy object`
1019
1020 Tool calls require user confirmation before execution.
1021
1022 - `BetaManagedAgentsAutoPolicy object`
1023
1024 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1025
1026 - `BetaManagedAgentsCustomToolParams object`
1027
1028 A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
3991029
4001030 - `type: "custom"`
4011031
402 - `skill_id: string`
403
404 Tagged ID of the custom skill (e.g., "skill_01XJ5...").
405
406 minLength: 1, maxLength: 64
407
408 - `version: optional string or null`
409
410 Version to pin. Defaults to latest if omitted.
411
412 minLength: 1, maxLength: 64
413
414- `system: optional string or null`
415
416 System prompt for the agent.
417
418 maxLength: 100000
419
420- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams`
421
422 Tool configurations available to the agent. Maximum of 256 tools across all toolsets allowed.
423
424 - `BetaManagedAgentsAgentToolset20260401Params object`
425
426 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
427
428 - `type: "agent_toolset_20260401"`
429
430 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
431
432 Per-tool configuration overrides.
433
434 - `BetaManagedAgentsBashToolConfigParams object`
435
436 Configuration override for the bash tool.
437
438 - `type: optional "bash"`
439
440 - `name: "bash"`
441
442 Must be "bash".
443
444 - `enabled: optional boolean or null`
445
446 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
447
448 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
449
450 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
451
452 - `BetaManagedAgentsAlwaysAllowPolicy object`
453
454 Tool calls are automatically approved without user confirmation.
455
456 - `type: "always_allow"`
457
458 - `BetaManagedAgentsAlwaysAskPolicy object`
459
460 Tool calls require user confirmation before execution.
461
462 - `type: "always_ask"`
463
464 - `BetaManagedAgentsAutoPolicy object`
465
466 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
467
468 - `type: "auto"`
469
470 - `BetaManagedAgentsEditToolConfigParams object`
471
472 Configuration override for the edit tool.
473
474 - `type: optional "edit"`
475
476 - `name: "edit"`
477
478 Must be "edit".
479
480 - `enabled: optional boolean or null`
481
482 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
483
484 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
485
486 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
487
488 - `BetaManagedAgentsAlwaysAllowPolicy object`
489
490 Tool calls are automatically approved without user confirmation.
491
492 - `BetaManagedAgentsAlwaysAskPolicy object`
493
494 Tool calls require user confirmation before execution.
495
496 - `BetaManagedAgentsAutoPolicy object`
497
498 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
499
500 - `BetaManagedAgentsReadToolConfigParams object`
501
502 Configuration override for the read tool.
503
504 - `type: optional "read"`
505
506 - `name: "read"`
507
508 Must be "read".
509
510 - `enabled: optional boolean or null`
511
512 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
513
514 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
515
516 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
517
518 - `BetaManagedAgentsAlwaysAllowPolicy object`
519
520 Tool calls are automatically approved without user confirmation.
521
522 - `BetaManagedAgentsAlwaysAskPolicy object`
523
524 Tool calls require user confirmation before execution.
525
526 - `BetaManagedAgentsAutoPolicy object`
527
528 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
529
530 - `BetaManagedAgentsWriteToolConfigParams object`
531
532 Configuration override for the write tool.
533
534 - `type: optional "write"`
535
536 - `name: "write"`
537
538 Must be "write".
539
540 - `enabled: optional boolean or null`
541
542 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
543
544 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
545
546 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
547
548 - `BetaManagedAgentsAlwaysAllowPolicy object`
549
550 Tool calls are automatically approved without user confirmation.
551
552 - `BetaManagedAgentsAlwaysAskPolicy object`
553
554 Tool calls require user confirmation before execution.
555
556 - `BetaManagedAgentsAutoPolicy object`
557
558 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
559
560 - `BetaManagedAgentsGlobToolConfigParams object`
561
562 Configuration override for the glob tool.
563
564 - `type: optional "glob"`
565
566 - `name: "glob"`
567
568 Must be "glob".
569
570 - `enabled: optional boolean or null`
571
572 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
573
574 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
575
576 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
577
578 - `BetaManagedAgentsAlwaysAllowPolicy object`
579
580 Tool calls are automatically approved without user confirmation.
581
582 - `BetaManagedAgentsAlwaysAskPolicy object`
583
584 Tool calls require user confirmation before execution.
585
586 - `BetaManagedAgentsAutoPolicy object`
587
588 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
589
590 - `BetaManagedAgentsGrepToolConfigParams object`
591
592 Configuration override for the grep tool.
593
594 - `type: optional "grep"`
595
596 - `name: "grep"`
597
598 Must be "grep".
599
600 - `enabled: optional boolean or null`
601
602 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
603
604 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
605
606 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
607
608 - `BetaManagedAgentsAlwaysAllowPolicy object`
609
610 Tool calls are automatically approved without user confirmation.
611
612 - `BetaManagedAgentsAlwaysAskPolicy object`
613
614 Tool calls require user confirmation before execution.
615
616 - `BetaManagedAgentsAutoPolicy object`
617
618 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
619
620 - `BetaManagedAgentsWebFetchToolConfigParams object`
621
622 Configuration override for the web_fetch tool.
623
624 - `type: optional "web_fetch"`
625
626 - `name: "web_fetch"`
627
628 Must be "web_fetch".
629
630 - `allowed_domains: optional array of string`
631
632 Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
633
634 - `blocked_domains: optional array of string`
635
636 Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
637
638 - `enabled: optional boolean or null`
639
640 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
641
642 - `max_content_tokens: optional number or null`
643
644 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
645
646 format: int32
647
648 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
649
650 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
651
652 - `BetaManagedAgentsAlwaysAllowPolicy object`
653
654 Tool calls are automatically approved without user confirmation.
655
656 - `BetaManagedAgentsAlwaysAskPolicy object`
657
658 Tool calls require user confirmation before execution.
659
660 - `BetaManagedAgentsAutoPolicy object`
661
662 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
663
664 - `url_sources: optional BetaManagedAgentsWebFetchURLSourcesParams or null`
665
666 Which sources contribute URLs the tool may fetch. Omit to allow every source.
667
668 - `client_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
669
670 Which custom tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be a custom tool in the same tools array.
671
672 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
673
674 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
675
676 - `"all"`
677
678 - `"none"`
679
680 - `BetaManagedAgentsWebFetchURLSourceToolFilter = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone or BetaManagedAgentsWebFetchURLSourceOnly or BetaManagedAgentsWebFetchURLSourceExcept`
681
682 Which tools' results contribute URLs that may be fetched.
683
684 - `BetaManagedAgentsWebFetchURLSourceAll object`
685
686 Every URL from this source may be fetched. This is the default.
687
688 - `type: "all"`
689
690 - `BetaManagedAgentsWebFetchURLSourceNone object`
691
692 This source contributes no URLs that may be fetched.
693
694 - `type: "none"`
695
696 - `BetaManagedAgentsWebFetchURLSourceOnly object`
697
698 Only the named tools' results contribute URLs that may be fetched.
699
700 - `type: "only"`
701
702 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
703
704 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
705
706 - `type: "tool_reference"`
707
708 Must be "tool_reference".
709
710 - `name: string`
711
712 Name of the tool. Compared exactly, so upper and lower case letters are different.
713
714 minLength: 1, maxLength: 128
715
716 - `BetaManagedAgentsWebFetchURLSourceExcept object`
717
718 Every tool's results contribute URLs that may be fetched, except the named tools' results.
719
720 - `type: "except"`
721
722 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
723
724 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
725
726 - `type: "tool_reference"`
727
728 Must be "tool_reference".
729
730 - `name: string`
731
732 Name of the tool. Compared exactly, so upper and lower case letters are different.
733
734 minLength: 1, maxLength: 128
735
736 - `server_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
737
738 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be "web_search" or "web_fetch".
739
740 - `user_input: optional BetaManagedAgentsWebFetchURLSourceUserInputParams or null`
741
742 Whether URLs in the text of user messages may be fetched: "all" (the default) or "none".
743
744 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
745
746 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
747
748 - `BetaManagedAgentsWebFetchURLSourceUserInput = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone`
749
750 Whether URLs in the text of user messages may be fetched.
751
752 - `BetaManagedAgentsWebFetchURLSourceAll object`
753
754 Every URL from this source may be fetched. This is the default.
755
756 - `BetaManagedAgentsWebFetchURLSourceNone object`
757
758 This source contributes no URLs that may be fetched.
759
760 - `BetaManagedAgentsWebSearchToolConfigParams object`
761
762 Configuration override for the web_search tool.
763
764 - `type: optional "web_search"`
765
766 - `name: "web_search"`
767
768 Must be "web_search".
769
770 - `allowed_domains: optional array of string`
771
772 Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
773
774 - `blocked_domains: optional array of string`
775
776 Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
777
778 - `enabled: optional boolean or null`
779
780 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
781
782 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
783
784 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
785
786 - `BetaManagedAgentsAlwaysAllowPolicy object`
787
788 Tool calls are automatically approved without user confirmation.
789
790 - `BetaManagedAgentsAlwaysAskPolicy object`
791
792 Tool calls require user confirmation before execution.
793
794 - `BetaManagedAgentsAutoPolicy object`
795
796 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
797
798 - `user_location: optional BetaManagedAgentsUserLocation or null`
799
800 Approximate user location for search result localization.
801
802 - `type: "approximate"`
803
804 Location precision. Only "approximate" is supported.
805
806 - `city: optional string or null`
807
808 City name.
809
810 minLength: 1, maxLength: 255
811
812 - `country: optional string or null`
813
814 Two-letter ISO 3166-1 country code, uppercase.
815
816 - `region: optional string or null`
817
818 Region or state name.
819
820 minLength: 1, maxLength: 255
821
822 - `timezone: optional string or null`
823
824 IANA timezone identifier, e.g. "America/Los_Angeles".
825
826 minLength: 1, maxLength: 255
827
828 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
829
830 Default configuration applied to all tools in this set.
831
832 - `enabled: optional boolean or null`
833
834 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
835
836 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
837
838 Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
839
840 - `BetaManagedAgentsAlwaysAllowPolicy object`
841
842 Tool calls are automatically approved without user confirmation.
843
844 - `BetaManagedAgentsAlwaysAskPolicy object`
845
846 Tool calls require user confirmation before execution.
847
848 - `BetaManagedAgentsAutoPolicy object`
849
850 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
851
852 - `BetaManagedAgentsMCPToolsetParams object`
853
854 Configuration for tools from an MCP server defined in `mcp_servers`.
855
856 - `type: "mcp_toolset"`
857
858 - `mcp_server_name: string`
859
860 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
861
862 minLength: 1, maxLength: 255
863
864 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
865
866 Per-tool configuration overrides.
867
868 - `name: string`
869
870 Name of the MCP tool to configure. 1-128 characters.
871
872 minLength: 1, maxLength: 128
873
874 - `enabled: optional boolean or null`
875
876 Whether this tool is enabled. Overrides the `default_config` setting.
877
878 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
879
880 Permission policy for this tool. Overrides the `default_config` setting.
881
882 - `BetaManagedAgentsAlwaysAllowPolicy object`
883
884 Tool calls are automatically approved without user confirmation.
885
886 - `BetaManagedAgentsAlwaysAskPolicy object`
887
888 Tool calls require user confirmation before execution.
889
890 - `BetaManagedAgentsAutoPolicy object`
891
892 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
893
894 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
895
896 Default configuration for all tools from this server.
897
898 - `enabled: optional boolean or null`
899
900 Whether tools are enabled by default. Defaults to true if not specified.
901
902 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
903
904 Default permission policy for tools from this server.
905
906 - `BetaManagedAgentsAlwaysAllowPolicy object`
907
908 Tool calls are automatically approved without user confirmation.
909
910 - `BetaManagedAgentsAlwaysAskPolicy object`
911
912 Tool calls require user confirmation before execution.
913
914 - `BetaManagedAgentsAutoPolicy object`
915
916 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
917
918 - `BetaManagedAgentsCustomToolParams object`
919
920 A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
921
922 - `type: "custom"`
923
9241032 - `description: string`
9251033
9261034 Description of what the tool does, shown to the agent to help it decide when to use the tool.
from line 1141
10331141
10341142 - `"claude-haiku-4-5"`
10351143
1036 Fastest model with near-frontier intelligence
1037
10381144 - `"claude-haiku-4-5-20251001"`
10391145
1040 Fastest model with near-frontier intelligence
1041
10421146 - `"claude-opus-4-5"`
10431147
10441148 Powerful intelligence for long-running agents and coding
from line 1215
11111215
11121216 Multiagent orchestration configuration. Null when the agent is single-threaded.
11131217
1114 - `type: "coordinator"`
1115
1116 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
1117
1118 Agents the coordinator may spawn as session threads, each resolved to a specific version.
1119
1120 - `BetaManagedAgentsAgentReference object`
1121
1122 A resolved agent reference with a concrete version.
1123
1124 - `type: "agent"`
1125
1126 - `id: string`
1127
1128 - `version: number`
1129
1130 format: int32
1131
1132 - `BetaManagedAgentsAdvisor object`
1133
1134 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1135
1136 - `type: "advisor"`
1137
1138 - `model: string`
1139
1140 The advisor model id.
1218 - `BetaManagedAgentsMultiagentCoordinator object`
1219
1220 Resolved coordinator topology with a concrete agent roster.
1221
1222 - `type: "coordinator"`
1223
1224 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
1225
1226 Agents the coordinator may spawn as session threads, each resolved to a specific version.
1227
1228 - `BetaManagedAgentsAgentReference object`
1229
1230 A resolved agent reference with a concrete version.
1231
1232 - `type: "agent"`
1233
1234 - `id: string`
1235
1236 - `version: number`
1237
1238 format: int32
1239
1240 - `BetaManagedAgentsAdvisor object`
1241
1242 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1243
1244 - `type: "advisor"`
1245
1246 - `model: string`
1247
1248 The advisor model id.
1249
1250 - `BetaManagedAgentsMultiagent20261001 object`
1251
1252 Resolved multiagent configuration with three members, each enabled or disabled on its own.
1253
1254 - `type: "multiagent_20261001"`
1255
1256 - `advisor: BetaManagedAgentsMultiagentAdvisor`
1257
1258 Whether the session's primary thread can consult an advisor model.
1259
1260 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
1261
1262 The session's primary thread can consult `model` mid-turn.
1263
1264 - `type: "enabled"`
1265
1266 - `model: string`
1267
1268 The advisor model id.
1269
1270 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
1271
1272 The agent has no advisor.
1273
1274 - `type: "disabled"`
1275
1276 - `subagents: BetaManagedAgentsMultiagentSubagents`
1277
1278 Whether the agent can spawn session threads.
1279
1280 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
1281
1282 The agent can spawn session threads.
1283
1284 - `type: "enabled"`
1285
1286 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1287
1288 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
1289
1290 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
1291
1292 The agent can define inline agents.
1293
1294 - `type: "enabled"`
1295
1296 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
1297
1298 The agent cannot define inline agents.
1299
1300 - `type: "disabled"`
1301
1302 - `predefined_agents: array of BetaManagedAgentsAgentReference`
1303
1304 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
1305
1306 - `type: "agent"`
1307
1308 - `id: string`
1309
1310 - `version: number`
1311
1312 format: int32
1313
1314 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
1315
1316 The agent cannot spawn session threads.
1317
1318 - `type: "disabled"`
1319
1320 - `workflows: BetaManagedAgentsMultiagentWorkflows`
1321
1322 Whether the agent can start workflow runs.
1323
1324 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
1325
1326 The agent can start workflow runs.
1327
1328 - `type: "enabled"`
1329
1330 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1331
1332 Whether a run's plan can define inline agents, which are not saved.
1333
1334 - `predefined_agents: array of BetaManagedAgentsAgentReference`
1335
1336 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
1337
1338 - `type: "agent"`
1339
1340 - `id: string`
1341
1342 - `version: number`
1343
1344 format: int32
1345
1346 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
1347
1348 The agent cannot start workflow runs.
1349
1350 - `type: "disabled"`
11411351
11421352 - `name: string`
11431353
from line 1833
16231833 "description": "A general-purpose starter agent.",
16241834 "metadata": {
16251835 "foo": "bar"
1626 },
1627 "multiagent": {
1628 "agents": [
1629 "agent_011CZkYqphY8vELVzwCUpqiQ",
1630 {
1631 "type": "self"
1632 }
1633 ],
1634 "type": "coordinator"
16351836 },
16361837 "system": "You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user'\''s task end to end.",
16371838 "tools": [
from line 1870
16691870 "speed": "standard"
16701871 },
16711872 "multiagent": {
1672 "agents": [
1673 {
1674 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1675 "type": "agent",
1676 "version": 1
1677 }
1678 ],
1679 "type": "coordinator"
1873 "advisor": {
1874 "type": "disabled"
1875 },
1876 "subagents": {
1877 "inline_agents": {
1878 "type": "enabled"
1879 },
1880 "predefined_agents": [
1881 {
1882 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1883 "type": "agent",
1884 "version": 1
1885 }
1886 ],
1887 "type": "enabled"
1888 },
1889 "type": "multiagent_20261001",
1890 "workflows": {
1891 "inline_agents": {
1892 "type": "enabled"
1893 },
1894 "predefined_agents": [
1895 {
1896 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
1897 "type": "agent",
1898 "version": 1
1899 }
1900 ],
1901 "type": "enabled"
1902 }
16801903 },
16811904 "name": "My First Agent",
16821905 "skills": [
from line 2182
19592182
19602183 - `"claude-haiku-4-5"`
19612184
1962 Fastest model with near-frontier intelligence
1963
19642185 - `"claude-haiku-4-5-20251001"`
19652186
1966 Fastest model with near-frontier intelligence
1967
19682187 - `"claude-opus-4-5"`
19692188
19702189 Powerful intelligence for long-running agents and coding
from line 2256
20372256
20382257 Multiagent orchestration configuration. Null when the agent is single-threaded.
20392258
2040 - `type: "coordinator"`
2041
2042 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
2043
2044 Agents the coordinator may spawn as session threads, each resolved to a specific version.
2045
2046 - `BetaManagedAgentsAgentReference object`
2047
2048 A resolved agent reference with a concrete version.
2049
2050 - `type: "agent"`
2051
2052 - `id: string`
2053
2054 - `version: number`
2055
2056 format: int32
2057
2058 - `BetaManagedAgentsAdvisor object`
2059
2060 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2061
2062 - `type: "advisor"`
2063
2064 - `model: string`
2065
2066 The advisor model id.
2259 - `BetaManagedAgentsMultiagentCoordinator object`
2260
2261 Resolved coordinator topology with a concrete agent roster.
2262
2263 - `type: "coordinator"`
2264
2265 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
2266
2267 Agents the coordinator may spawn as session threads, each resolved to a specific version.
2268
2269 - `BetaManagedAgentsAgentReference object`
2270
2271 A resolved agent reference with a concrete version.
2272
2273 - `type: "agent"`
2274
2275 - `id: string`
2276
2277 - `version: number`
2278
2279 format: int32
2280
2281 - `BetaManagedAgentsAdvisor object`
2282
2283 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2284
2285 - `type: "advisor"`
2286
2287 - `model: string`
2288
2289 The advisor model id.
2290
2291 - `BetaManagedAgentsMultiagent20261001 object`
2292
2293 Resolved multiagent configuration with three members, each enabled or disabled on its own.
2294
2295 - `type: "multiagent_20261001"`
2296
2297 - `advisor: BetaManagedAgentsMultiagentAdvisor`
2298
2299 Whether the session's primary thread can consult an advisor model.
2300
2301 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
2302
2303 The session's primary thread can consult `model` mid-turn.
2304
2305 - `type: "enabled"`
2306
2307 - `model: string`
2308
2309 The advisor model id.
2310
2311 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
2312
2313 The agent has no advisor.
2314
2315 - `type: "disabled"`
2316
2317 - `subagents: BetaManagedAgentsMultiagentSubagents`
2318
2319 Whether the agent can spawn session threads.
2320
2321 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
2322
2323 The agent can spawn session threads.
2324
2325 - `type: "enabled"`
2326
2327 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2328
2329 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
2330
2331 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
2332
2333 The agent can define inline agents.
2334
2335 - `type: "enabled"`
2336
2337 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
2338
2339 The agent cannot define inline agents.
2340
2341 - `type: "disabled"`
2342
2343 - `predefined_agents: array of BetaManagedAgentsAgentReference`
2344
2345 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
2346
2347 - `type: "agent"`
2348
2349 - `id: string`
2350
2351 - `version: number`
2352
2353 format: int32
2354
2355 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
2356
2357 The agent cannot spawn session threads.
2358
2359 - `type: "disabled"`
2360
2361 - `workflows: BetaManagedAgentsMultiagentWorkflows`
2362
2363 Whether the agent can start workflow runs.
2364
2365 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
2366
2367 The agent can start workflow runs.
2368
2369 - `type: "enabled"`
2370
2371 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
2372
2373 Whether a run's plan can define inline agents, which are not saved.
2374
2375 - `predefined_agents: array of BetaManagedAgentsAgentReference`
2376
2377 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
2378
2379 - `type: "agent"`
2380
2381 - `id: string`
2382
2383 - `version: number`
2384
2385 format: int32
2386
2387 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
2388
2389 The agent cannot start workflow runs.
2390
2391 - `type: "disabled"`
20672392
20682393 - `name: string`
20692394
from line 2902
25772902 "speed": "standard"
25782903 },
25792904 "multiagent": {
2580 "agents": [
2581 {
2582 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
2583 "type": "agent",
2584 "version": 1
2585 }
2586 ],
2587 "type": "coordinator"
2905 "advisor": {
2906 "type": "disabled"
2907 },
2908 "subagents": {
2909 "inline_agents": {
2910 "type": "enabled"
2911 },
2912 "predefined_agents": [
2913 {
2914 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
2915 "type": "agent",
2916 "version": 1
2917 }
2918 ],
2919 "type": "enabled"
2920 },
2921 "type": "multiagent_20261001",
2922 "workflows": {
2923 "inline_agents": {
2924 "type": "enabled"
2925 },
2926 "predefined_agents": [
2927 {
2928 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
2929 "type": "agent",
2930 "version": 1
2931 }
2932 ],
2933 "type": "enabled"
2934 }
25882935 },
25892936 "name": "My First Agent",
25902937 "skills": [
from line 3203
28563203
28573204 - `"claude-haiku-4-5"`
28583205
2859 Fastest model with near-frontier intelligence
2860
28613206 - `"claude-haiku-4-5-20251001"`
28623207
2863 Fastest model with near-frontier intelligence
2864
28653208 - `"claude-opus-4-5"`
28663209
28673210 Powerful intelligence for long-running agents and coding
from line 3277
29343277
29353278 Multiagent orchestration configuration. Null when the agent is single-threaded.
29363279
2937 - `type: "coordinator"`
2938
2939 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
2940
2941 Agents the coordinator may spawn as session threads, each resolved to a specific version.
2942
2943 - `BetaManagedAgentsAgentReference object`
2944
2945 A resolved agent reference with a concrete version.
2946
2947 - `type: "agent"`
2948
2949 - `id: string`
2950
2951 - `version: number`
2952
2953 format: int32
2954
2955 - `BetaManagedAgentsAdvisor object`
2956
2957 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
2958
2959 - `type: "advisor"`
2960
2961 - `model: string`
2962
2963 The advisor model id.
3280 - `BetaManagedAgentsMultiagentCoordinator object`
3281
3282 Resolved coordinator topology with a concrete agent roster.
3283
3284 - `type: "coordinator"`
3285
3286 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
3287
3288 Agents the coordinator may spawn as session threads, each resolved to a specific version.
3289
3290 - `BetaManagedAgentsAgentReference object`
3291
3292 A resolved agent reference with a concrete version.
3293
3294 - `type: "agent"`
3295
3296 - `id: string`
3297
3298 - `version: number`
3299
3300 format: int32
3301
3302 - `BetaManagedAgentsAdvisor object`
3303
3304 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
3305
3306 - `type: "advisor"`
3307
3308 - `model: string`
3309
3310 The advisor model id.
3311
3312 - `BetaManagedAgentsMultiagent20261001 object`
3313
3314 Resolved multiagent configuration with three members, each enabled or disabled on its own.
3315
3316 - `type: "multiagent_20261001"`
3317
3318 - `advisor: BetaManagedAgentsMultiagentAdvisor`
3319
3320 Whether the session's primary thread can consult an advisor model.
3321
3322 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
3323
3324 The session's primary thread can consult `model` mid-turn.
3325
3326 - `type: "enabled"`
3327
3328 - `model: string`
3329
3330 The advisor model id.
3331
3332 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
3333
3334 The agent has no advisor.
3335
3336 - `type: "disabled"`
3337
3338 - `subagents: BetaManagedAgentsMultiagentSubagents`
3339
3340 Whether the agent can spawn session threads.
3341
3342 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
3343
3344 The agent can spawn session threads.
3345
3346 - `type: "enabled"`
3347
3348 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
3349
3350 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
3351
3352 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
3353
3354 The agent can define inline agents.
3355
3356 - `type: "enabled"`
3357
3358 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
3359
3360 The agent cannot define inline agents.
3361
3362 - `type: "disabled"`
3363
3364 - `predefined_agents: array of BetaManagedAgentsAgentReference`
3365
3366 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
3367
3368 - `type: "agent"`
3369
3370 - `id: string`
3371
3372 - `version: number`
3373
3374 format: int32
3375
3376 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
3377
3378 The agent cannot spawn session threads.
3379
3380 - `type: "disabled"`
3381
3382 - `workflows: BetaManagedAgentsMultiagentWorkflows`
3383
3384 Whether the agent can start workflow runs.
3385
3386 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
3387
3388 The agent can start workflow runs.
3389
3390 - `type: "enabled"`
3391
3392 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
3393
3394 Whether a run's plan can define inline agents, which are not saved.
3395
3396 - `predefined_agents: array of BetaManagedAgentsAgentReference`
3397
3398 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
3399
3400 - `type: "agent"`
3401
3402 - `id: string`
3403
3404 - `version: number`
3405
3406 format: int32
3407
3408 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
3409
3410 The agent cannot start workflow runs.
3411
3412 - `type: "disabled"`
29643413
29653414 - `name: string`
29663415
from line 3917
34683917 "speed": "standard"
34693918 },
34703919 "multiagent": {
3471 "agents": [
3472 {
3473 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
3474 "type": "agent",
3475 "version": 1
3476 }
3477 ],
3478 "type": "coordinator"
3920 "advisor": {
3921 "type": "disabled"
3922 },
3923 "subagents": {
3924 "inline_agents": {
3925 "type": "enabled"
3926 },
3927 "predefined_agents": [
3928 {
3929 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
3930 "type": "agent",
3931 "version": 1
3932 }
3933 ],
3934 "type": "enabled"
3935 },
3936 "type": "multiagent_20261001",
3937 "workflows": {
3938 "inline_agents": {
3939 "type": "enabled"
3940 },
3941 "predefined_agents": [
3942 {
3943 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
3944 "type": "agent",
3945 "version": 1
3946 }
3947 ],
3948 "type": "enabled"
3949 }
34793950 },
34803951 "name": "My First Agent",
34813952 "skills": [
from line 4203
37324203
37334204 - `"claude-haiku-4-5"`
37344205
3735 Fastest model with near-frontier intelligence
3736
37374206 - `"claude-haiku-4-5-20251001"`
37384207
3739 Fastest model with near-frontier intelligence
3740
37414208 - `"claude-opus-4-5"`
37424209
37434210 Powerful intelligence for long-running agents and coding
from line 4307
38404307
38414308 Multiagent orchestration configuration. Full replacement. Omit to preserve; send null to clear.
38424309
3843 - `type: "coordinator"`
3844
3845 - `agents: array of BetaManagedAgentsMultiagentRosterEntryParams`
3846
3847 Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1).
3848
3849 - `string`
3850
3851 - `BetaManagedAgentsAgentParams object`
3852
3853 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
3854
3855 - `type: "agent"`
3856
3857 - `id: string`
3858
3859 The `agent` ID.
4310 - `BetaManagedAgentsMultiagentCoordinatorParams object`
4311
4312 A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.
4313
4314 - `type: "coordinator"`
4315
4316 - `agents: array of BetaManagedAgentsMultiagentRosterEntryParams`
4317
4318 Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or `{"type":"self"}` to allow recursive self-invocation. Entries must reference distinct agents (after resolving `self` and string forms); at most one `self`. Referenced agents must exist, must not be archived, and must not themselves have `multiagent` set (depth limit 1).
4319
4320 - `string`
4321
4322 - `BetaManagedAgentsAgentParams object`
4323
4324 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
4325
4326 - `type: "agent"`
4327
4328 - `id: string`
4329
4330 The `agent` ID.
4331
4332 minLength: 1, maxLength: 128
4333
4334 - `version: optional number`
4335
4336 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
4337
4338 format: int32
4339
4340 - `BetaManagedAgentsMultiagentSelfParams object`
4341
4342 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
4343
4344 - `type: "self"`
4345
4346 - `BetaManagedAgentsAdvisorParams object`
4347
4348 Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.
4349
4350 - `type: "advisor"`
4351
4352 - `model: string`
4353
4354 A Claude model id. The model must be permitted as an advisor for this agent's model.
4355
4356 minLength: 1, maxLength: 256
4357
4358 - `BetaManagedAgentsMultiagent20261001Params object`
4359
4360 Multiagent configuration with three members, each enabled or disabled on its own. On an update, if the agent's stored `multiagent` also has type `multiagent_20261001`, this configuration is merged into the stored one, level by level, instead of replacing it. A key that the update omits keeps its stored value. A key sent as null takes its default, on create as well, so `"workflows": null` enables workflows. An object sent with a `type` other than the stored one replaces the stored object, and the keys that it omits take their defaults. A `predefined_agents` list that is sent replaces the stored list. Every object that is sent needs its `type`, and an enabled `advisor` needs its `model`. Other validation applies to the merged result.
4361
4362 - `type: "multiagent_20261001"`
4363
4364 - `advisor: optional BetaManagedAgentsMultiagentAdvisorParams or null`
4365
4366 Whether the session's primary thread can consult an advisor model. Defaults to disabled.
4367
4368 - `BetaManagedAgentsMultiagentAdvisorEnabledParams object`
4369
4370 The session's primary thread can consult `model` mid-turn.
4371
4372 - `type: "enabled"`
4373
4374 - `model: string`
4375
4376 A Claude model id. The model must be permitted as an advisor for this agent's model.
4377
4378 minLength: 1, maxLength: 256
4379
4380 - `BetaManagedAgentsMultiagentAdvisorDisabledParams object`
4381
4382 The agent has no advisor.
4383
4384 - `type: "disabled"`
4385
4386 - `subagents: optional BetaManagedAgentsMultiagentSubagentsParams or null`
4387
4388 Whether the agent can spawn session threads. Defaults to enabled.
4389
4390 - `BetaManagedAgentsMultiagentSubagentsEnabledParams object`
4391
4392 The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
4393
4394 - `type: "enabled"`
4395
4396 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
4397
4398 Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.
4399
4400 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
4401
4402 The agent can define inline agents.
4403
4404 - `type: "enabled"`
4405
4406 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
4407
4408 The agent cannot define inline agents.
4409
4410 - `type: "disabled"`
4411
4412 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
4413
4414 Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other.
4415
4416 - `string`
4417
4418 - `BetaManagedAgentsAgentParams object`
4419
4420 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
4421
4422 - `BetaManagedAgentsMultiagentSelfParams object`
4423
4424 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
4425
4426 - `BetaManagedAgentsMultiagentSubagentsDisabledParams object`
4427
4428 The agent cannot spawn session threads.
4429
4430 - `type: "disabled"`
4431
4432 - `workflows: optional BetaManagedAgentsMultiagentWorkflowsParams or null`
4433
4434 Whether the agent can start workflow runs. Defaults to enabled.
4435
4436 - `BetaManagedAgentsMultiagentWorkflowsEnabledParams object`
4437
4438 The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
4439
4440 - `type: "enabled"`
4441
4442 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
4443
4444 Whether a run's plan can define inline agents. Defaults to enabled.
4445
4446 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
4447
4448 Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other.
4449
4450 - `string`
4451
4452 - `BetaManagedAgentsAgentParams object`
4453
4454 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
4455
4456 - `BetaManagedAgentsMultiagentSelfParams object`
4457
4458 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
4459
4460 - `BetaManagedAgentsMultiagentWorkflowsDisabledParams object`
4461
4462 The agent cannot start workflow runs.
4463
4464 - `type: "disabled"`
4465
4466- `name: optional string`
4467
4468 Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
4469
4470 maxLength: 256
4471
4472- `skills: optional array of BetaManagedAgentsSkillParams or null`
4473
4474 Skills. Full replacement. Omit to preserve; send empty array or null to clear.
4475
4476 - `BetaManagedAgentsAnthropicSkillParams object`
4477
4478 An Anthropic-managed skill.
4479
4480 - `type: "anthropic"`
4481
4482 - `skill_id: string`
4483
4484 Identifier of the Anthropic skill (e.g., "xlsx").
4485
4486 minLength: 1, maxLength: 64
4487
4488 - `version: optional string or null`
4489
4490 Version to pin. Defaults to latest if omitted.
4491
4492 minLength: 1, maxLength: 64
4493
4494 - `BetaManagedAgentsCustomSkillParams object`
4495
4496 A user-created custom skill.
4497
4498 - `type: "custom"`
4499
4500 - `skill_id: string`
4501
4502 Tagged ID of the custom skill (e.g., "skill_01XJ5...").
4503
4504 minLength: 1, maxLength: 64
4505
4506 - `version: optional string or null`
4507
4508 Version to pin. Defaults to latest if omitted.
4509
4510 minLength: 1, maxLength: 64
4511
4512- `system: optional string or null`
4513
4514 System prompt. Omit to preserve; send empty string or null to clear.
4515
4516 maxLength: 100000
4517
4518- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams or null`
4519
4520 Tool configurations available to the agent. Full replacement. Omit to preserve; send empty array or null to clear. Maximum of 256 tools across all toolsets allowed.
4521
4522 - `BetaManagedAgentsAgentToolset20260401Params object`
4523
4524 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
4525
4526 - `type: "agent_toolset_20260401"`
4527
4528 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
4529
4530 Per-tool configuration overrides.
4531
4532 - `BetaManagedAgentsBashToolConfigParams object`
4533
4534 Configuration override for the bash tool.
4535
4536 - `type: optional "bash"`
4537
4538 - `name: "bash"`
4539
4540 Must be "bash".
4541
4542 - `enabled: optional boolean or null`
4543
4544 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4545
4546 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4547
4548 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4549
4550 - `BetaManagedAgentsAlwaysAllowPolicy object`
4551
4552 Tool calls are automatically approved without user confirmation.
4553
4554 - `type: "always_allow"`
4555
4556 - `BetaManagedAgentsAlwaysAskPolicy object`
4557
4558 Tool calls require user confirmation before execution.
4559
4560 - `type: "always_ask"`
4561
4562 - `BetaManagedAgentsAutoPolicy object`
4563
4564 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4565
4566 - `type: "auto"`
4567
4568 - `BetaManagedAgentsEditToolConfigParams object`
4569
4570 Configuration override for the edit tool.
4571
4572 - `type: optional "edit"`
4573
4574 - `name: "edit"`
4575
4576 Must be "edit".
4577
4578 - `enabled: optional boolean or null`
4579
4580 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4581
4582 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4583
4584 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4585
4586 - `BetaManagedAgentsAlwaysAllowPolicy object`
4587
4588 Tool calls are automatically approved without user confirmation.
4589
4590 - `BetaManagedAgentsAlwaysAskPolicy object`
4591
4592 Tool calls require user confirmation before execution.
4593
4594 - `BetaManagedAgentsAutoPolicy object`
4595
4596 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4597
4598 - `BetaManagedAgentsReadToolConfigParams object`
4599
4600 Configuration override for the read tool.
4601
4602 - `type: optional "read"`
4603
4604 - `name: "read"`
4605
4606 Must be "read".
4607
4608 - `enabled: optional boolean or null`
4609
4610 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4611
4612 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4613
4614 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4615
4616 - `BetaManagedAgentsAlwaysAllowPolicy object`
4617
4618 Tool calls are automatically approved without user confirmation.
4619
4620 - `BetaManagedAgentsAlwaysAskPolicy object`
4621
4622 Tool calls require user confirmation before execution.
4623
4624 - `BetaManagedAgentsAutoPolicy object`
4625
4626 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4627
4628 - `BetaManagedAgentsWriteToolConfigParams object`
4629
4630 Configuration override for the write tool.
4631
4632 - `type: optional "write"`
4633
4634 - `name: "write"`
4635
4636 Must be "write".
4637
4638 - `enabled: optional boolean or null`
4639
4640 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4641
4642 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4643
4644 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4645
4646 - `BetaManagedAgentsAlwaysAllowPolicy object`
4647
4648 Tool calls are automatically approved without user confirmation.
4649
4650 - `BetaManagedAgentsAlwaysAskPolicy object`
4651
4652 Tool calls require user confirmation before execution.
4653
4654 - `BetaManagedAgentsAutoPolicy object`
4655
4656 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4657
4658 - `BetaManagedAgentsGlobToolConfigParams object`
4659
4660 Configuration override for the glob tool.
4661
4662 - `type: optional "glob"`
4663
4664 - `name: "glob"`
4665
4666 Must be "glob".
4667
4668 - `enabled: optional boolean or null`
4669
4670 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4671
4672 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4673
4674 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4675
4676 - `BetaManagedAgentsAlwaysAllowPolicy object`
4677
4678 Tool calls are automatically approved without user confirmation.
4679
4680 - `BetaManagedAgentsAlwaysAskPolicy object`
4681
4682 Tool calls require user confirmation before execution.
4683
4684 - `BetaManagedAgentsAutoPolicy object`
4685
4686 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4687
4688 - `BetaManagedAgentsGrepToolConfigParams object`
4689
4690 Configuration override for the grep tool.
4691
4692 - `type: optional "grep"`
4693
4694 - `name: "grep"`
4695
4696 Must be "grep".
4697
4698 - `enabled: optional boolean or null`
4699
4700 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4701
4702 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4703
4704 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4705
4706 - `BetaManagedAgentsAlwaysAllowPolicy object`
4707
4708 Tool calls are automatically approved without user confirmation.
4709
4710 - `BetaManagedAgentsAlwaysAskPolicy object`
4711
4712 Tool calls require user confirmation before execution.
4713
4714 - `BetaManagedAgentsAutoPolicy object`
4715
4716 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4717
4718 - `BetaManagedAgentsWebFetchToolConfigParams object`
4719
4720 Configuration override for the web_fetch tool.
4721
4722 - `type: optional "web_fetch"`
4723
4724 - `name: "web_fetch"`
4725
4726 Must be "web_fetch".
4727
4728 - `allowed_domains: optional array of string`
4729
4730 Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
4731
4732 - `blocked_domains: optional array of string`
4733
4734 Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
4735
4736 - `enabled: optional boolean or null`
4737
4738 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4739
4740 - `max_content_tokens: optional number or null`
4741
4742 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
4743
4744 format: int32
4745
4746 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4747
4748 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4749
4750 - `BetaManagedAgentsAlwaysAllowPolicy object`
4751
4752 Tool calls are automatically approved without user confirmation.
4753
4754 - `BetaManagedAgentsAlwaysAskPolicy object`
4755
4756 Tool calls require user confirmation before execution.
4757
4758 - `BetaManagedAgentsAutoPolicy object`
4759
4760 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4761
4762 - `url_sources: optional BetaManagedAgentsWebFetchURLSourcesParams or null`
4763
4764 Which sources contribute URLs the tool may fetch. Omit to allow every source.
4765
4766 - `client_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
4767
4768 Which custom tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be a custom tool in the same tools array.
4769
4770 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
4771
4772 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
4773
4774 - `"all"`
4775
4776 - `"none"`
4777
4778 - `BetaManagedAgentsWebFetchURLSourceToolFilter = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone or BetaManagedAgentsWebFetchURLSourceOnly or BetaManagedAgentsWebFetchURLSourceExcept`
4779
4780 Which tools' results contribute URLs that may be fetched.
4781
4782 - `BetaManagedAgentsWebFetchURLSourceAll object`
4783
4784 Every URL from this source may be fetched. This is the default.
4785
4786 - `type: "all"`
4787
4788 - `BetaManagedAgentsWebFetchURLSourceNone object`
4789
4790 This source contributes no URLs that may be fetched.
4791
4792 - `type: "none"`
4793
4794 - `BetaManagedAgentsWebFetchURLSourceOnly object`
4795
4796 Only the named tools' results contribute URLs that may be fetched.
4797
4798 - `type: "only"`
4799
4800 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
4801
4802 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
4803
4804 - `type: "tool_reference"`
4805
4806 Must be "tool_reference".
4807
4808 - `name: string`
4809
4810 Name of the tool. Compared exactly, so upper and lower case letters are different.
4811
4812 minLength: 1, maxLength: 128
4813
4814 - `BetaManagedAgentsWebFetchURLSourceExcept object`
4815
4816 Every tool's results contribute URLs that may be fetched, except the named tools' results.
4817
4818 - `type: "except"`
4819
4820 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
4821
4822 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
4823
4824 - `type: "tool_reference"`
4825
4826 Must be "tool_reference".
4827
4828 - `name: string`
4829
4830 Name of the tool. Compared exactly, so upper and lower case letters are different.
4831
4832 minLength: 1, maxLength: 128
4833
4834 - `server_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
4835
4836 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be "web_search" or "web_fetch".
4837
4838 - `user_input: optional BetaManagedAgentsWebFetchURLSourceUserInputParams or null`
4839
4840 Whether URLs in the text of user messages may be fetched: "all" (the default) or "none".
4841
4842 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
4843
4844 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
4845
4846 - `BetaManagedAgentsWebFetchURLSourceUserInput = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone`
4847
4848 Whether URLs in the text of user messages may be fetched.
4849
4850 - `BetaManagedAgentsWebFetchURLSourceAll object`
4851
4852 Every URL from this source may be fetched. This is the default.
4853
4854 - `BetaManagedAgentsWebFetchURLSourceNone object`
4855
4856 This source contributes no URLs that may be fetched.
4857
4858 - `BetaManagedAgentsWebSearchToolConfigParams object`
4859
4860 Configuration override for the web_search tool.
4861
4862 - `type: optional "web_search"`
4863
4864 - `name: "web_search"`
4865
4866 Must be "web_search".
4867
4868 - `allowed_domains: optional array of string`
4869
4870 Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
4871
4872 - `blocked_domains: optional array of string`
4873
4874 Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
4875
4876 - `enabled: optional boolean or null`
4877
4878 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4879
4880 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4881
4882 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4883
4884 - `BetaManagedAgentsAlwaysAllowPolicy object`
4885
4886 Tool calls are automatically approved without user confirmation.
4887
4888 - `BetaManagedAgentsAlwaysAskPolicy object`
4889
4890 Tool calls require user confirmation before execution.
4891
4892 - `BetaManagedAgentsAutoPolicy object`
4893
4894 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4895
4896 - `user_location: optional BetaManagedAgentsUserLocation or null`
4897
4898 Approximate user location for search result localization.
4899
4900 - `type: "approximate"`
4901
4902 Location precision. Only "approximate" is supported.
4903
4904 - `city: optional string or null`
4905
4906 City name.
4907
4908 minLength: 1, maxLength: 255
4909
4910 - `country: optional string or null`
4911
4912 Two-letter ISO 3166-1 country code, uppercase.
4913
4914 - `region: optional string or null`
4915
4916 Region or state name.
4917
4918 minLength: 1, maxLength: 255
4919
4920 - `timezone: optional string or null`
4921
4922 IANA timezone identifier, e.g. "America/Los_Angeles".
4923
4924 minLength: 1, maxLength: 255
4925
4926 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
4927
4928 Default configuration applied to all tools in this set.
4929
4930 - `enabled: optional boolean or null`
4931
4932 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
4933
4934 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4935
4936 Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
4937
4938 - `BetaManagedAgentsAlwaysAllowPolicy object`
4939
4940 Tool calls are automatically approved without user confirmation.
4941
4942 - `BetaManagedAgentsAlwaysAskPolicy object`
4943
4944 Tool calls require user confirmation before execution.
4945
4946 - `BetaManagedAgentsAutoPolicy object`
4947
4948 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4949
4950 - `BetaManagedAgentsMCPToolsetParams object`
4951
4952 Configuration for tools from an MCP server defined in `mcp_servers`.
4953
4954 - `type: "mcp_toolset"`
4955
4956 - `mcp_server_name: string`
4957
4958 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
4959
4960 minLength: 1, maxLength: 255
4961
4962 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
4963
4964 Per-tool configuration overrides.
4965
4966 - `name: string`
4967
4968 Name of the MCP tool to configure. 1-128 characters.
38604969
38614970 minLength: 1, maxLength: 128
38624971
3863 - `version: optional number`
3864
3865 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
3866
3867 format: int32
3868
3869 - `BetaManagedAgentsMultiagentSelfParams object`
3870
3871 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
3872
3873 - `type: "self"`
3874
3875 - `BetaManagedAgentsAdvisorParams object`
3876
3877 Platform advisor roster entry: a model the session's primary thread may consult mid-turn. At most one per roster; the entry occupies the roster name `anthropic.advisor`.
3878
3879 - `type: "advisor"`
3880
3881 - `model: string`
3882
3883 A Claude model id. The model must be permitted as an advisor for this agent's model.
3884
3885 minLength: 1, maxLength: 256
3886
3887- `name: optional string`
3888
3889 Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
3890
3891 maxLength: 256
3892
3893- `skills: optional array of BetaManagedAgentsSkillParams or null`
3894
3895 Skills. Full replacement. Omit to preserve; send empty array or null to clear.
3896
3897 - `BetaManagedAgentsAnthropicSkillParams object`
3898
3899 An Anthropic-managed skill.
3900
3901 - `type: "anthropic"`
3902
3903 - `skill_id: string`
3904
3905 Identifier of the Anthropic skill (e.g., "xlsx").
3906
3907 minLength: 1, maxLength: 64
3908
3909 - `version: optional string or null`
3910
3911 Version to pin. Defaults to latest if omitted.
3912
3913 minLength: 1, maxLength: 64
3914
3915 - `BetaManagedAgentsCustomSkillParams object`
3916
3917 A user-created custom skill.
4972 - `enabled: optional boolean or null`
4973
4974 Whether this tool is enabled. Overrides the `default_config` setting.
4975
4976 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4977
4978 Permission policy for this tool. Overrides the `default_config` setting.
4979
4980 - `BetaManagedAgentsAlwaysAllowPolicy object`
4981
4982 Tool calls are automatically approved without user confirmation.
4983
4984 - `BetaManagedAgentsAlwaysAskPolicy object`
4985
4986 Tool calls require user confirmation before execution.
4987
4988 - `BetaManagedAgentsAutoPolicy object`
4989
4990 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4991
4992 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
4993
4994 Default configuration for all tools from this server.
4995
4996 - `enabled: optional boolean or null`
4997
4998 Whether tools are enabled by default. Defaults to true if not specified.
4999
5000 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
5001
5002 Default permission policy for tools from this server.
5003
5004 - `BetaManagedAgentsAlwaysAllowPolicy object`
5005
5006 Tool calls are automatically approved without user confirmation.
5007
5008 - `BetaManagedAgentsAlwaysAskPolicy object`
5009
5010 Tool calls require user confirmation before execution.
5011
5012 - `BetaManagedAgentsAutoPolicy object`
5013
5014 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
5015
5016 - `BetaManagedAgentsCustomToolParams object`
5017
5018 A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
39185019
39195020 - `type: "custom"`
39205021
3921 - `skill_id: string`
3922
3923 Tagged ID of the custom skill (e.g., "skill_01XJ5...").
3924
3925 minLength: 1, maxLength: 64
3926
3927 - `version: optional string or null`
3928
3929 Version to pin. Defaults to latest if omitted.
3930
3931 minLength: 1, maxLength: 64
3932
3933- `system: optional string or null`
3934
3935 System prompt. Omit to preserve; send empty string or null to clear.
3936
3937 maxLength: 100000
3938
3939- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams or null`
3940
3941 Tool configurations available to the agent. Full replacement. Omit to preserve; send empty array or null to clear. Maximum of 256 tools across all toolsets allowed.
3942
3943 - `BetaManagedAgentsAgentToolset20260401Params object`
3944
3945 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
3946
3947 - `type: "agent_toolset_20260401"`
3948
3949 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
3950
3951 Per-tool configuration overrides.
3952
3953 - `BetaManagedAgentsBashToolConfigParams object`
3954
3955 Configuration override for the bash tool.
3956
3957 - `type: optional "bash"`
3958
3959 - `name: "bash"`
3960
3961 Must be "bash".
3962
3963 - `enabled: optional boolean or null`
3964
3965 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3966
3967 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
3968
3969 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
3970
3971 - `BetaManagedAgentsAlwaysAllowPolicy object`
3972
3973 Tool calls are automatically approved without user confirmation.
3974
3975 - `type: "always_allow"`
3976
3977 - `BetaManagedAgentsAlwaysAskPolicy object`
3978
3979 Tool calls require user confirmation before execution.
3980
3981 - `type: "always_ask"`
3982
3983 - `BetaManagedAgentsAutoPolicy object`
3984
3985 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
3986
3987 - `type: "auto"`
3988
3989 - `BetaManagedAgentsEditToolConfigParams object`
3990
3991 Configuration override for the edit tool.
3992
3993 - `type: optional "edit"`
3994
3995 - `name: "edit"`
3996
3997 Must be "edit".
3998
3999 - `enabled: optional boolean or null`
4000
4001 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4002
4003 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4004
4005 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4006
4007 - `BetaManagedAgentsAlwaysAllowPolicy object`
4008
4009 Tool calls are automatically approved without user confirmation.
4010
4011 - `BetaManagedAgentsAlwaysAskPolicy object`
4012
4013 Tool calls require user confirmation before execution.
4014
4015 - `BetaManagedAgentsAutoPolicy object`
4016
4017 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4018
4019 - `BetaManagedAgentsReadToolConfigParams object`
4020
4021 Configuration override for the read tool.
4022
4023 - `type: optional "read"`
4024
4025 - `name: "read"`
4026
4027 Must be "read".
4028
4029 - `enabled: optional boolean or null`
4030
4031 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4032
4033 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4034
4035 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4036
4037 - `BetaManagedAgentsAlwaysAllowPolicy object`
4038
4039 Tool calls are automatically approved without user confirmation.
4040
4041 - `BetaManagedAgentsAlwaysAskPolicy object`
4042
4043 Tool calls require user confirmation before execution.
4044
4045 - `BetaManagedAgentsAutoPolicy object`
4046
4047 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4048
4049 - `BetaManagedAgentsWriteToolConfigParams object`
4050
4051 Configuration override for the write tool.
4052
4053 - `type: optional "write"`
4054
4055 - `name: "write"`
4056
4057 Must be "write".
4058
4059 - `enabled: optional boolean or null`
4060
4061 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4062
4063 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4064
4065 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4066
4067 - `BetaManagedAgentsAlwaysAllowPolicy object`
4068
4069 Tool calls are automatically approved without user confirmation.
4070
4071 - `BetaManagedAgentsAlwaysAskPolicy object`
4072
4073 Tool calls require user confirmation before execution.
4074
4075 - `BetaManagedAgentsAutoPolicy object`
4076
4077 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4078
4079 - `BetaManagedAgentsGlobToolConfigParams object`
4080
4081 Configuration override for the glob tool.
4082
4083 - `type: optional "glob"`
4084
4085 - `name: "glob"`
4086
4087 Must be "glob".
4088
4089 - `enabled: optional boolean or null`
4090
4091 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4092
4093 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4094
4095 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4096
4097 - `BetaManagedAgentsAlwaysAllowPolicy object`
4098
4099 Tool calls are automatically approved without user confirmation.
4100
4101 - `BetaManagedAgentsAlwaysAskPolicy object`
4102
4103 Tool calls require user confirmation before execution.
4104
4105 - `BetaManagedAgentsAutoPolicy object`
4106
4107 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4108
4109 - `BetaManagedAgentsGrepToolConfigParams object`
4110
4111 Configuration override for the grep tool.
4112
4113 - `type: optional "grep"`
4114
4115 - `name: "grep"`
4116
4117 Must be "grep".
4118
4119 - `enabled: optional boolean or null`
4120
4121 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4122
4123 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4124
4125 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4126
4127 - `BetaManagedAgentsAlwaysAllowPolicy object`
4128
4129 Tool calls are automatically approved without user confirmation.
4130
4131 - `BetaManagedAgentsAlwaysAskPolicy object`
4132
4133 Tool calls require user confirmation before execution.
4134
4135 - `BetaManagedAgentsAutoPolicy object`
4136
4137 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4138
4139 - `BetaManagedAgentsWebFetchToolConfigParams object`
4140
4141 Configuration override for the web_fetch tool.
4142
4143 - `type: optional "web_fetch"`
4144
4145 - `name: "web_fetch"`
4146
4147 Must be "web_fetch".
4148
4149 - `allowed_domains: optional array of string`
4150
4151 Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
4152
4153 - `blocked_domains: optional array of string`
4154
4155 Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
4156
4157 - `enabled: optional boolean or null`
4158
4159 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4160
4161 - `max_content_tokens: optional number or null`
4162
4163 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
4164
4165 format: int32
4166
4167 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4168
4169 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4170
4171 - `BetaManagedAgentsAlwaysAllowPolicy object`
4172
4173 Tool calls are automatically approved without user confirmation.
4174
4175 - `BetaManagedAgentsAlwaysAskPolicy object`
4176
4177 Tool calls require user confirmation before execution.
4178
4179 - `BetaManagedAgentsAutoPolicy object`
4180
4181 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4182
4183 - `url_sources: optional BetaManagedAgentsWebFetchURLSourcesParams or null`
4184
4185 Which sources contribute URLs the tool may fetch. Omit to allow every source.
4186
4187 - `client_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
4188
4189 Which custom tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be a custom tool in the same tools array.
4190
4191 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
4192
4193 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
4194
4195 - `"all"`
4196
4197 - `"none"`
4198
4199 - `BetaManagedAgentsWebFetchURLSourceToolFilter = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone or BetaManagedAgentsWebFetchURLSourceOnly or BetaManagedAgentsWebFetchURLSourceExcept`
4200
4201 Which tools' results contribute URLs that may be fetched.
4202
4203 - `BetaManagedAgentsWebFetchURLSourceAll object`
4204
4205 Every URL from this source may be fetched. This is the default.
4206
4207 - `type: "all"`
4208
4209 - `BetaManagedAgentsWebFetchURLSourceNone object`
4210
4211 This source contributes no URLs that may be fetched.
4212
4213 - `type: "none"`
4214
4215 - `BetaManagedAgentsWebFetchURLSourceOnly object`
4216
4217 Only the named tools' results contribute URLs that may be fetched.
4218
4219 - `type: "only"`
4220
4221 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
4222
4223 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
4224
4225 - `type: "tool_reference"`
4226
4227 Must be "tool_reference".
4228
4229 - `name: string`
4230
4231 Name of the tool. Compared exactly, so upper and lower case letters are different.
4232
4233 minLength: 1, maxLength: 128
4234
4235 - `BetaManagedAgentsWebFetchURLSourceExcept object`
4236
4237 Every tool's results contribute URLs that may be fetched, except the named tools' results.
4238
4239 - `type: "except"`
4240
4241 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
4242
4243 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
4244
4245 - `type: "tool_reference"`
4246
4247 Must be "tool_reference".
4248
4249 - `name: string`
4250
4251 Name of the tool. Compared exactly, so upper and lower case letters are different.
4252
4253 minLength: 1, maxLength: 128
4254
4255 - `server_tool_results: optional BetaManagedAgentsWebFetchURLSourceToolFilterParams or null`
4256
4257 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched: "all" (the default), "none", or an only or except list. Each name in a list must be "web_search" or "web_fetch".
4258
4259 - `user_input: optional BetaManagedAgentsWebFetchURLSourceUserInputParams or null`
4260
4261 Whether URLs in the text of user messages may be fetched: "all" (the default) or "none".
4262
4263 - `BetaManagedAgentsWebFetchURLSourceShorthand = "all" or "none"`
4264
4265 String form of a url_sources value that has no field other than its type: "all" means {"type": "all"} and "none" means {"type": "none"}.
4266
4267 - `BetaManagedAgentsWebFetchURLSourceUserInput = BetaManagedAgentsWebFetchURLSourceAll or BetaManagedAgentsWebFetchURLSourceNone`
4268
4269 Whether URLs in the text of user messages may be fetched.
4270
4271 - `BetaManagedAgentsWebFetchURLSourceAll object`
4272
4273 Every URL from this source may be fetched. This is the default.
4274
4275 - `BetaManagedAgentsWebFetchURLSourceNone object`
4276
4277 This source contributes no URLs that may be fetched.
4278
4279 - `BetaManagedAgentsWebSearchToolConfigParams object`
4280
4281 Configuration override for the web_search tool.
4282
4283 - `type: optional "web_search"`
4284
4285 - `name: "web_search"`
4286
4287 Must be "web_search".
4288
4289 - `allowed_domains: optional array of string`
4290
4291 Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
4292
4293 - `blocked_domains: optional array of string`
4294
4295 Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
4296
4297 - `enabled: optional boolean or null`
4298
4299 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4300
4301 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4302
4303 Permission policy for this tool. Controls whether tool calls are auto-approved or require confirmation.
4304
4305 - `BetaManagedAgentsAlwaysAllowPolicy object`
4306
4307 Tool calls are automatically approved without user confirmation.
4308
4309 - `BetaManagedAgentsAlwaysAskPolicy object`
4310
4311 Tool calls require user confirmation before execution.
4312
4313 - `BetaManagedAgentsAutoPolicy object`
4314
4315 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4316
4317 - `user_location: optional BetaManagedAgentsUserLocation or null`
4318
4319 Approximate user location for search result localization.
4320
4321 - `type: "approximate"`
4322
4323 Location precision. Only "approximate" is supported.
4324
4325 - `city: optional string or null`
4326
4327 City name.
4328
4329 minLength: 1, maxLength: 255
4330
4331 - `country: optional string or null`
4332
4333 Two-letter ISO 3166-1 country code, uppercase.
4334
4335 - `region: optional string or null`
4336
4337 Region or state name.
4338
4339 minLength: 1, maxLength: 255
4340
4341 - `timezone: optional string or null`
4342
4343 IANA timezone identifier, e.g. "America/Los_Angeles".
4344
4345 minLength: 1, maxLength: 255
4346
4347 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
4348
4349 Default configuration applied to all tools in this set.
4350
4351 - `enabled: optional boolean or null`
4352
4353 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
4354
4355 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4356
4357 Default permission policy for tools. Controls whether tool calls are auto-approved or require confirmation.
4358
4359 - `BetaManagedAgentsAlwaysAllowPolicy object`
4360
4361 Tool calls are automatically approved without user confirmation.
4362
4363 - `BetaManagedAgentsAlwaysAskPolicy object`
4364
4365 Tool calls require user confirmation before execution.
4366
4367 - `BetaManagedAgentsAutoPolicy object`
4368
4369 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4370
4371 - `BetaManagedAgentsMCPToolsetParams object`
4372
4373 Configuration for tools from an MCP server defined in `mcp_servers`.
4374
4375 - `type: "mcp_toolset"`
4376
4377 - `mcp_server_name: string`
4378
4379 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
4380
4381 minLength: 1, maxLength: 255
4382
4383 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
4384
4385 Per-tool configuration overrides.
4386
4387 - `name: string`
4388
4389 Name of the MCP tool to configure. 1-128 characters.
4390
4391 minLength: 1, maxLength: 128
4392
4393 - `enabled: optional boolean or null`
4394
4395 Whether this tool is enabled. Overrides the `default_config` setting.
4396
4397 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4398
4399 Permission policy for this tool. Overrides the `default_config` setting.
4400
4401 - `BetaManagedAgentsAlwaysAllowPolicy object`
4402
4403 Tool calls are automatically approved without user confirmation.
4404
4405 - `BetaManagedAgentsAlwaysAskPolicy object`
4406
4407 Tool calls require user confirmation before execution.
4408
4409 - `BetaManagedAgentsAutoPolicy object`
4410
4411 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4412
4413 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
4414
4415 Default configuration for all tools from this server.
4416
4417 - `enabled: optional boolean or null`
4418
4419 Whether tools are enabled by default. Defaults to true if not specified.
4420
4421 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy or null`
4422
4423 Default permission policy for tools from this server.
4424
4425 - `BetaManagedAgentsAlwaysAllowPolicy object`
4426
4427 Tool calls are automatically approved without user confirmation.
4428
4429 - `BetaManagedAgentsAlwaysAskPolicy object`
4430
4431 Tool calls require user confirmation before execution.
4432
4433 - `BetaManagedAgentsAutoPolicy object`
4434
4435 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
4436
4437 - `BetaManagedAgentsCustomToolParams object`
4438
4439 A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
4440
4441 - `type: "custom"`
4442
44435022 - `description: string`
44445023
44455024 Description of what the tool does, shown to the agent to help it decide when to use the tool.
from line 5137
45585137
45595138 - `"claude-haiku-4-5"`
45605139
4561 Fastest model with near-frontier intelligence
4562
45635140 - `"claude-haiku-4-5-20251001"`
45645141
4565 Fastest model with near-frontier intelligence
4566
45675142 - `"claude-opus-4-5"`
45685143
45695144 Powerful intelligence for long-running agents and coding
from line 5211
46365211
46375212 Multiagent orchestration configuration. Null when the agent is single-threaded.
46385213
4639 - `type: "coordinator"`
4640
4641 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
4642
4643 Agents the coordinator may spawn as session threads, each resolved to a specific version.
4644
4645 - `BetaManagedAgentsAgentReference object`
4646
4647 A resolved agent reference with a concrete version.
4648
4649 - `type: "agent"`
4650
4651 - `id: string`
4652
4653 - `version: number`
4654
4655 format: int32
4656
4657 - `BetaManagedAgentsAdvisor object`
4658
4659 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
4660
4661 - `type: "advisor"`
4662
4663 - `model: string`
4664
4665 The advisor model id.
5214 - `BetaManagedAgentsMultiagentCoordinator object`
5215
5216 Resolved coordinator topology with a concrete agent roster.
5217
5218 - `type: "coordinator"`
5219
5220 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
5221
5222 Agents the coordinator may spawn as session threads, each resolved to a specific version.
5223
5224 - `BetaManagedAgentsAgentReference object`
5225
5226 A resolved agent reference with a concrete version.
5227
5228 - `type: "agent"`
5229
5230 - `id: string`
5231
5232 - `version: number`
5233
5234 format: int32
5235
5236 - `BetaManagedAgentsAdvisor object`
5237
5238 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
5239
5240 - `type: "advisor"`
5241
5242 - `model: string`
5243
5244 The advisor model id.
5245
5246 - `BetaManagedAgentsMultiagent20261001 object`
5247
5248 Resolved multiagent configuration with three members, each enabled or disabled on its own.
5249
5250 - `type: "multiagent_20261001"`
5251
5252 - `advisor: BetaManagedAgentsMultiagentAdvisor`
5253
5254 Whether the session's primary thread can consult an advisor model.
5255
5256 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
5257
5258 The session's primary thread can consult `model` mid-turn.
5259
5260 - `type: "enabled"`
5261
5262 - `model: string`
5263
5264 The advisor model id.
5265
5266 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
5267
5268 The agent has no advisor.
5269
5270 - `type: "disabled"`
5271
5272 - `subagents: BetaManagedAgentsMultiagentSubagents`
5273
5274 Whether the agent can spawn session threads.
5275
5276 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
5277
5278 The agent can spawn session threads.
5279
5280 - `type: "enabled"`
5281
5282 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
5283
5284 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
5285
5286 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
5287
5288 The agent can define inline agents.
5289
5290 - `type: "enabled"`
5291
5292 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
5293
5294 The agent cannot define inline agents.
5295
5296 - `type: "disabled"`
5297
5298 - `predefined_agents: array of BetaManagedAgentsAgentReference`
5299
5300 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
5301
5302 - `type: "agent"`
5303
5304 - `id: string`
5305
5306 - `version: number`
5307
5308 format: int32
5309
5310 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
5311
5312 The agent cannot spawn session threads.
5313
5314 - `type: "disabled"`
5315
5316 - `workflows: BetaManagedAgentsMultiagentWorkflows`
5317
5318 Whether the agent can start workflow runs.
5319
5320 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
5321
5322 The agent can start workflow runs.
5323
5324 - `type: "enabled"`
5325
5326 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
5327
5328 Whether a run's plan can define inline agents, which are not saved.
5329
5330 - `predefined_agents: array of BetaManagedAgentsAgentReference`
5331
5332 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
5333
5334 - `type: "agent"`
5335
5336 - `id: string`
5337
5338 - `version: number`
5339
5340 format: int32
5341
5342 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
5343
5344 The agent cannot start workflow runs.
5345
5346 - `type: "disabled"`
46665347
46675348 - `name: string`
46685349
from line 5825
51445825 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
51455826 -d '{
51465827 "description": "updated",
5147 "multiagent": {
5148 "agents": [
5149 "agent_011CZkYqphY8vELVzwCUpqiQ",
5150 {
5151 "type": "self"
5152 }
5153 ],
5154 "type": "coordinator"
5155 },
51565828 "system": "You are a general-purpose agent that can research, write code, run commands, and use connected tools to complete the user'\''s task end to end.",
51575829 "version": 1
51585830 }'
from line 5857
51855857 "speed": "standard"
51865858 },
51875859 "multiagent": {
5188 "agents": [
5189 {
5190 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
5191 "type": "agent",
5192 "version": 1
5193 }
5194 ],
5195 "type": "coordinator"
5860 "advisor": {
5861 "type": "disabled"
5862 },
5863 "subagents": {
5864 "inline_agents": {
5865 "type": "enabled"
5866 },
5867 "predefined_agents": [
5868 {
5869 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
5870 "type": "agent",
5871 "version": 1
5872 }
5873 ],
5874 "type": "enabled"
5875 },
5876 "type": "multiagent_20261001",
5877 "workflows": {
5878 "inline_agents": {
5879 "type": "enabled"
5880 },
5881 "predefined_agents": [
5882 {
5883 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
5884 "type": "agent",
5885 "version": 1
5886 }
5887 ],
5888 "type": "enabled"
5889 }
51965890 },
51975891 "name": "My First Agent",
51985892 "skills": [
from line 6147
54536147
54546148 - `"claude-haiku-4-5"`
54556149
5456 Fastest model with near-frontier intelligence
5457
54586150 - `"claude-haiku-4-5-20251001"`
54596151
5460 Fastest model with near-frontier intelligence
5461
54626152 - `"claude-opus-4-5"`
54636153
54646154 Powerful intelligence for long-running agents and coding
from line 6221
55316221
55326222 Multiagent orchestration configuration. Null when the agent is single-threaded.
55336223
5534 - `type: "coordinator"`
5535
5536 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
5537
5538 Agents the coordinator may spawn as session threads, each resolved to a specific version.
5539
5540 - `BetaManagedAgentsAgentReference object`
5541
5542 A resolved agent reference with a concrete version.
5543
5544 - `type: "agent"`
5545
5546 - `id: string`
5547
5548 - `version: number`
5549
5550 format: int32
5551
5552 - `BetaManagedAgentsAdvisor object`
5553
5554 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
5555
5556 - `type: "advisor"`
5557
5558 - `model: string`
5559
5560 The advisor model id.
6224 - `BetaManagedAgentsMultiagentCoordinator object`
6225
6226 Resolved coordinator topology with a concrete agent roster.
6227
6228 - `type: "coordinator"`
6229
6230 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
6231
6232 Agents the coordinator may spawn as session threads, each resolved to a specific version.
6233
6234 - `BetaManagedAgentsAgentReference object`
6235
6236 A resolved agent reference with a concrete version.
6237
6238 - `type: "agent"`
6239
6240 - `id: string`
6241
6242 - `version: number`
6243
6244 format: int32
6245
6246 - `BetaManagedAgentsAdvisor object`
6247
6248 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
6249
6250 - `type: "advisor"`
6251
6252 - `model: string`
6253
6254 The advisor model id.
6255
6256 - `BetaManagedAgentsMultiagent20261001 object`
6257
6258 Resolved multiagent configuration with three members, each enabled or disabled on its own.
6259
6260 - `type: "multiagent_20261001"`
6261
6262 - `advisor: BetaManagedAgentsMultiagentAdvisor`
6263
6264 Whether the session's primary thread can consult an advisor model.
6265
6266 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
6267
6268 The session's primary thread can consult `model` mid-turn.
6269
6270 - `type: "enabled"`
6271
6272 - `model: string`
6273
6274 The advisor model id.
6275
6276 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
6277
6278 The agent has no advisor.
6279
6280 - `type: "disabled"`
6281
6282 - `subagents: BetaManagedAgentsMultiagentSubagents`
6283
6284 Whether the agent can spawn session threads.
6285
6286 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
6287
6288 The agent can spawn session threads.
6289
6290 - `type: "enabled"`
6291
6292 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
6293
6294 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
6295
6296 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
6297
6298 The agent can define inline agents.
6299
6300 - `type: "enabled"`
6301
6302 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
6303
6304 The agent cannot define inline agents.
6305
6306 - `type: "disabled"`
6307
6308 - `predefined_agents: array of BetaManagedAgentsAgentReference`
6309
6310 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
6311
6312 - `type: "agent"`
6313
6314 - `id: string`
6315
6316 - `version: number`
6317
6318 format: int32
6319
6320 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
6321
6322 The agent cannot spawn session threads.
6323
6324 - `type: "disabled"`
6325
6326 - `workflows: BetaManagedAgentsMultiagentWorkflows`
6327
6328 Whether the agent can start workflow runs.
6329
6330 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
6331
6332 The agent can start workflow runs.
6333
6334 - `type: "enabled"`
6335
6336 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
6337
6338 Whether a run's plan can define inline agents, which are not saved.
6339
6340 - `predefined_agents: array of BetaManagedAgentsAgentReference`
6341
6342 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
6343
6344 - `type: "agent"`
6345
6346 - `id: string`
6347
6348 - `version: number`
6349
6350 format: int32
6351
6352 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
6353
6354 The agent cannot start workflow runs.
6355
6356 - `type: "disabled"`
55616357
55626358 - `name: string`
55636359
from line 6862
60666862 "speed": "standard"
60676863 },
60686864 "multiagent": {
6069 "agents": [
6070 {
6071 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
6072 "type": "agent",
6073 "version": 1
6074 }
6075 ],
6076 "type": "coordinator"
6865 "advisor": {
6866 "type": "disabled"
6867 },
6868 "subagents": {
6869 "inline_agents": {
6870 "type": "enabled"
6871 },
6872 "predefined_agents": [
6873 {
6874 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
6875 "type": "agent",
6876 "version": 1
6877 }
6878 ],
6879 "type": "enabled"
6880 },
6881 "type": "multiagent_20261001",
6882 "workflows": {
6883 "inline_agents": {
6884 "type": "enabled"
6885 },
6886 "predefined_agents": [
6887 {
6888 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
6889 "type": "agent",
6890 "version": 1
6891 }
6892 ],
6893 "type": "enabled"
6894 }
60776895 },
60786896 "name": "My First Agent",
60796897 "skills": [
from line 7038
62207038
62217039 - `"claude-haiku-4-5"`
62227040
6223 Fastest model with near-frontier intelligence
6224
62257041 - `"claude-haiku-4-5-20251001"`
62267042
6227 Fastest model with near-frontier intelligence
6228
62297043 - `"claude-opus-4-5"`
62307044
62317045 Powerful intelligence for long-running agents and coding
from line 7112
62987112
62997113 Multiagent orchestration configuration. Null when the agent is single-threaded.
63007114
6301 - `type: "coordinator"`
6302
6303 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
6304
6305 Agents the coordinator may spawn as session threads, each resolved to a specific version.
6306
6307 - `BetaManagedAgentsAgentReference object`
6308
6309 A resolved agent reference with a concrete version.
6310
6311 - `type: "agent"`
6312
6313 - `id: string`
6314
6315 - `version: number`
6316
6317 format: int32
6318
6319 - `BetaManagedAgentsAdvisor object`
6320
6321 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
6322
6323 - `type: "advisor"`
6324
6325 - `model: string`
6326
6327 The advisor model id.
7115 - `BetaManagedAgentsMultiagentCoordinator object`
7116
7117 Resolved coordinator topology with a concrete agent roster.
7118
7119 - `type: "coordinator"`
7120
7121 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
7122
7123 Agents the coordinator may spawn as session threads, each resolved to a specific version.
7124
7125 - `BetaManagedAgentsAgentReference object`
7126
7127 A resolved agent reference with a concrete version.
7128
7129 - `type: "agent"`
7130
7131 - `id: string`
7132
7133 - `version: number`
7134
7135 format: int32
7136
7137 - `BetaManagedAgentsAdvisor object`
7138
7139 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
7140
7141 - `type: "advisor"`
7142
7143 - `model: string`
7144
7145 The advisor model id.
7146
7147 - `BetaManagedAgentsMultiagent20261001 object`
7148
7149 Resolved multiagent configuration with three members, each enabled or disabled on its own.
7150
7151 - `type: "multiagent_20261001"`
7152
7153 - `advisor: BetaManagedAgentsMultiagentAdvisor`
7154
7155 Whether the session's primary thread can consult an advisor model.
7156
7157 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
7158
7159 The session's primary thread can consult `model` mid-turn.
7160
7161 - `type: "enabled"`
7162
7163 - `model: string`
7164
7165 The advisor model id.
7166
7167 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
7168
7169 The agent has no advisor.
7170
7171 - `type: "disabled"`
7172
7173 - `subagents: BetaManagedAgentsMultiagentSubagents`
7174
7175 Whether the agent can spawn session threads.
7176
7177 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
7178
7179 The agent can spawn session threads.
7180
7181 - `type: "enabled"`
7182
7183 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
7184
7185 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
7186
7187 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
7188
7189 The agent can define inline agents.
7190
7191 - `type: "enabled"`
7192
7193 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
7194
7195 The agent cannot define inline agents.
7196
7197 - `type: "disabled"`
7198
7199 - `predefined_agents: array of BetaManagedAgentsAgentReference`
7200
7201 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
7202
7203 - `type: "agent"`
7204
7205 - `id: string`
7206
7207 - `version: number`
7208
7209 format: int32
7210
7211 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
7212
7213 The agent cannot spawn session threads.
7214
7215 - `type: "disabled"`
7216
7217 - `workflows: BetaManagedAgentsMultiagentWorkflows`
7218
7219 Whether the agent can start workflow runs.
7220
7221 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
7222
7223 The agent can start workflow runs.
7224
7225 - `type: "enabled"`
7226
7227 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
7228
7229 Whether a run's plan can define inline agents, which are not saved.
7230
7231 - `predefined_agents: array of BetaManagedAgentsAgentReference`
7232
7233 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
7234
7235 - `type: "agent"`
7236
7237 - `id: string`
7238
7239 - `version: number`
7240
7241 format: int32
7242
7243 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
7244
7245 The agent cannot start workflow runs.
7246
7247 - `type: "disabled"`
63287248
63297249 - `name: string`
63307250
from line 10252
933210252
933310253 - `"claude-haiku-4-5"`
933410254
9335 Fastest model with near-frontier intelligence
9336
933710255 - `"claude-haiku-4-5-20251001"`
933810256
9339 Fastest model with near-frontier intelligence
9340
934110257 - `"claude-opus-4-5"`
934210258
934310259 Powerful intelligence for long-running agents and coding
from line 10334
941810334
941910335 - `"claude-haiku-4-5"`
942010336
9421 Fastest model with near-frontier intelligence
9422
942310337 - `"claude-haiku-4-5-20251001"`
942410338
9425 Fastest model with near-frontier intelligence
9426
942710339 - `"claude-opus-4-5"`
942810340
942910341 Powerful intelligence for long-running agents and coding
from line 10462
955010462
955110463 - `"claude-haiku-4-5"`
955210464
9553 Fastest model with near-frontier intelligence
9554
955510465 - `"claude-haiku-4-5-20251001"`
955610466
9557 Fastest model with near-frontier intelligence
9558
955910467 - `"claude-opus-4-5"`
956010468
956110469 Powerful intelligence for long-running agents and coding
from line 10552
964410552
964510553 - `"fast"`
964610554
10555### Beta Managed Agents Multiagent Advisor
10556
10557- `BetaManagedAgentsMultiagentAdvisor = BetaManagedAgentsMultiagentAdvisorEnabled or BetaManagedAgentsMultiagentAdvisorDisabled`
10558
10559 Whether the session's primary thread can consult an advisor model.
10560
10561 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
10562
10563 The session's primary thread can consult `model` mid-turn.
10564
10565 - `type: "enabled"`
10566
10567 - `model: string`
10568
10569 The advisor model id.
10570
10571 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
10572
10573 The agent has no advisor.
10574
10575 - `type: "disabled"`
10576
10577### Beta Managed Agents Multiagent Advisor Disabled
10578
10579- `BetaManagedAgentsMultiagentAdvisorDisabled object`
10580
10581 The agent has no advisor.
10582
10583 - `type: "disabled"`
10584
10585### Beta Managed Agents Multiagent Advisor Disabled Params
10586
10587- `BetaManagedAgentsMultiagentAdvisorDisabledParams object`
10588
10589 The agent has no advisor.
10590
10591 - `type: "disabled"`
10592
10593### Beta Managed Agents Multiagent Advisor Enabled
10594
10595- `BetaManagedAgentsMultiagentAdvisorEnabled object`
10596
10597 The session's primary thread can consult `model` mid-turn.
10598
10599 - `type: "enabled"`
10600
10601 - `model: string`
10602
10603 The advisor model id.
10604
10605### Beta Managed Agents Multiagent Advisor Enabled Params
10606
10607- `BetaManagedAgentsMultiagentAdvisorEnabledParams object`
10608
10609 The session's primary thread can consult `model` mid-turn.
10610
10611 - `type: "enabled"`
10612
10613 - `model: string`
10614
10615 A Claude model id. The model must be permitted as an advisor for this agent's model.
10616
10617 minLength: 1, maxLength: 256
10618
10619### Beta Managed Agents Multiagent Advisor Params
10620
10621- `BetaManagedAgentsMultiagentAdvisorParams = BetaManagedAgentsMultiagentAdvisorEnabledParams or BetaManagedAgentsMultiagentAdvisorDisabledParams`
10622
10623 Whether the session's primary thread can consult an advisor model.
10624
10625 - `BetaManagedAgentsMultiagentAdvisorEnabledParams object`
10626
10627 The session's primary thread can consult `model` mid-turn.
10628
10629 - `type: "enabled"`
10630
10631 - `model: string`
10632
10633 A Claude model id. The model must be permitted as an advisor for this agent's model.
10634
10635 minLength: 1, maxLength: 256
10636
10637 - `BetaManagedAgentsMultiagentAdvisorDisabledParams object`
10638
10639 The agent has no advisor.
10640
10641 - `type: "disabled"`
10642
964710643### Beta Managed Agents Multiagent Coordinator
964810644
964910645- `BetaManagedAgentsMultiagentCoordinator object`
from line 10724
972810724
972910725 minLength: 1, maxLength: 256
973010726
10727### Beta Managed Agents Multiagent Inline Agents
10728
10729- `BetaManagedAgentsMultiagentInlineAgents = BetaManagedAgentsMultiagentInlineAgentsEnabled or BetaManagedAgentsMultiagentInlineAgentsDisabled`
10730
10731 Whether the agent can define inline agents. The agent defines an inline agent itself, in a workflow run's plan or when it spawns a session thread, and the inline agent is not saved.
10732
10733 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
10734
10735 The agent can define inline agents.
10736
10737 - `type: "enabled"`
10738
10739 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
10740
10741 The agent cannot define inline agents.
10742
10743 - `type: "disabled"`
10744
10745### Beta Managed Agents Multiagent Inline Agents Disabled
10746
10747- `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
10748
10749 The agent cannot define inline agents.
10750
10751 - `type: "disabled"`
10752
10753### Beta Managed Agents Multiagent Inline Agents Disabled Params
10754
10755- `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
10756
10757 The agent cannot define inline agents.
10758
10759 - `type: "disabled"`
10760
10761### Beta Managed Agents Multiagent Inline Agents Enabled
10762
10763- `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
10764
10765 The agent can define inline agents.
10766
10767 - `type: "enabled"`
10768
10769### Beta Managed Agents Multiagent Inline Agents Enabled Params
10770
10771- `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
10772
10773 The agent can define inline agents.
10774
10775 - `type: "enabled"`
10776
10777### Beta Managed Agents Multiagent Inline Agents Params
10778
10779- `BetaManagedAgentsMultiagentInlineAgentsParams = BetaManagedAgentsMultiagentInlineAgentsEnabledParams or BetaManagedAgentsMultiagentInlineAgentsDisabledParams`
10780
10781 Whether the agent can define inline agents. The agent defines an inline agent itself, in a workflow run's plan or when it spawns a session thread, and the inline agent is not saved.
10782
10783 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
10784
10785 The agent can define inline agents.
10786
10787 - `type: "enabled"`
10788
10789 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
10790
10791 The agent cannot define inline agents.
10792
10793 - `type: "disabled"`
10794
10795### Beta Managed Agents Multiagent Predefined Agent Params
10796
10797- `BetaManagedAgentsMultiagentPredefinedAgentParams = string or BetaManagedAgentsAgentParams or BetaManagedAgentsMultiagentSelfParams`
10798
10799 One agent in a `predefined_agents` list. It is an agent ID string, an `agent` reference with an optional `version`, or `self` for the agent that owns this configuration.
10800
10801 - `string`
10802
10803 - `BetaManagedAgentsAgentParams object`
10804
10805 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
10806
10807 - `type: "agent"`
10808
10809 - `id: string`
10810
10811 The `agent` ID.
10812
10813 minLength: 1, maxLength: 128
10814
10815 - `version: optional number`
10816
10817 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
10818
10819 format: int32
10820
10821 - `BetaManagedAgentsMultiagentSelfParams object`
10822
10823 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
10824
10825 - `type: "self"`
10826
973110827### Beta Managed Agents Multiagent Self Params
973210828
973310829- `BetaManagedAgentsMultiagentSelfParams object`
from line 10832
973610832
973710833 - `type: "self"`
973810834
10835### Beta Managed Agents Multiagent Subagents
10836
10837- `BetaManagedAgentsMultiagentSubagents = BetaManagedAgentsMultiagentSubagentsEnabled or BetaManagedAgentsMultiagentSubagentsDisabled`
10838
10839 Whether the agent can spawn session threads.
10840
10841 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
10842
10843 The agent can spawn session threads.
10844
10845 - `type: "enabled"`
10846
10847 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
10848
10849 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
10850
10851 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
10852
10853 The agent can define inline agents.
10854
10855 - `type: "enabled"`
10856
10857 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
10858
10859 The agent cannot define inline agents.
10860
10861 - `type: "disabled"`
10862
10863 - `predefined_agents: array of BetaManagedAgentsAgentReference`
10864
10865 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
10866
10867 - `type: "agent"`
10868
10869 - `id: string`
10870
10871 - `version: number`
10872
10873 format: int32
10874
10875 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
10876
10877 The agent cannot spawn session threads.
10878
10879 - `type: "disabled"`
10880
10881### Beta Managed Agents Multiagent Subagents Disabled
10882
10883- `BetaManagedAgentsMultiagentSubagentsDisabled object`
10884
10885 The agent cannot spawn session threads.
10886
10887 - `type: "disabled"`
10888
10889### Beta Managed Agents Multiagent Subagents Disabled Params
10890
10891- `BetaManagedAgentsMultiagentSubagentsDisabledParams object`
10892
10893 The agent cannot spawn session threads.
10894
10895 - `type: "disabled"`
10896
10897### Beta Managed Agents Multiagent Subagents Enabled
10898
10899- `BetaManagedAgentsMultiagentSubagentsEnabled object`
10900
10901 The agent can spawn session threads.
10902
10903 - `type: "enabled"`
10904
10905 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
10906
10907 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
10908
10909 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
10910
10911 The agent can define inline agents.
10912
10913 - `type: "enabled"`
10914
10915 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
10916
10917 The agent cannot define inline agents.
10918
10919 - `type: "disabled"`
10920
10921 - `predefined_agents: array of BetaManagedAgentsAgentReference`
10922
10923 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
10924
10925 - `type: "agent"`
10926
10927 - `id: string`
10928
10929 - `version: number`
10930
10931 format: int32
10932
10933### Beta Managed Agents Multiagent Subagents Enabled Params
10934
10935- `BetaManagedAgentsMultiagentSubagentsEnabledParams object`
10936
10937 The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
10938
10939 - `type: "enabled"`
10940
10941 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
10942
10943 Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.
10944
10945 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
10946
10947 The agent can define inline agents.
10948
10949 - `type: "enabled"`
10950
10951 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
10952
10953 The agent cannot define inline agents.
10954
10955 - `type: "disabled"`
10956
10957 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
10958
10959 Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other.
10960
10961 - `string`
10962
10963 - `BetaManagedAgentsAgentParams object`
10964
10965 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
10966
10967 - `type: "agent"`
10968
10969 - `id: string`
10970
10971 The `agent` ID.
10972
10973 minLength: 1, maxLength: 128
10974
10975 - `version: optional number`
10976
10977 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
10978
10979 format: int32
10980
10981 - `BetaManagedAgentsMultiagentSelfParams object`
10982
10983 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
10984
10985 - `type: "self"`
10986
10987### Beta Managed Agents Multiagent Subagents Params
10988
10989- `BetaManagedAgentsMultiagentSubagentsParams = BetaManagedAgentsMultiagentSubagentsEnabledParams or BetaManagedAgentsMultiagentSubagentsDisabledParams`
10990
10991 Whether the agent can spawn session threads.
10992
10993 - `BetaManagedAgentsMultiagentSubagentsEnabledParams object`
10994
10995 The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
10996
10997 - `type: "enabled"`
10998
10999 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
11000
11001 Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.
11002
11003 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
11004
11005 The agent can define inline agents.
11006
11007 - `type: "enabled"`
11008
11009 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
11010
11011 The agent cannot define inline agents.
11012
11013 - `type: "disabled"`
11014
11015 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
11016
11017 Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other.
11018
11019 - `string`
11020
11021 - `BetaManagedAgentsAgentParams object`
11022
11023 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
11024
11025 - `type: "agent"`
11026
11027 - `id: string`
11028
11029 The `agent` ID.
11030
11031 minLength: 1, maxLength: 128
11032
11033 - `version: optional number`
11034
11035 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
11036
11037 format: int32
11038
11039 - `BetaManagedAgentsMultiagentSelfParams object`
11040
11041 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
11042
11043 - `type: "self"`
11044
11045 - `BetaManagedAgentsMultiagentSubagentsDisabledParams object`
11046
11047 The agent cannot spawn session threads.
11048
11049 - `type: "disabled"`
11050
11051### Beta Managed Agents Multiagent Workflows
11052
11053- `BetaManagedAgentsMultiagentWorkflows = BetaManagedAgentsMultiagentWorkflowsEnabled or BetaManagedAgentsMultiagentWorkflowsDisabled`
11054
11055 Whether the agent can start workflow runs.
11056
11057 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
11058
11059 The agent can start workflow runs.
11060
11061 - `type: "enabled"`
11062
11063 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
11064
11065 Whether a run's plan can define inline agents, which are not saved.
11066
11067 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
11068
11069 The agent can define inline agents.
11070
11071 - `type: "enabled"`
11072
11073 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
11074
11075 The agent cannot define inline agents.
11076
11077 - `type: "disabled"`
11078
11079 - `predefined_agents: array of BetaManagedAgentsAgentReference`
11080
11081 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
11082
11083 - `type: "agent"`
11084
11085 - `id: string`
11086
11087 - `version: number`
11088
11089 format: int32
11090
11091 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
11092
11093 The agent cannot start workflow runs.
11094
11095 - `type: "disabled"`
11096
11097### Beta Managed Agents Multiagent Workflows Disabled
11098
11099- `BetaManagedAgentsMultiagentWorkflowsDisabled object`
11100
11101 The agent cannot start workflow runs.
11102
11103 - `type: "disabled"`
11104
11105### Beta Managed Agents Multiagent Workflows Disabled Params
11106
11107- `BetaManagedAgentsMultiagentWorkflowsDisabledParams object`
11108
11109 The agent cannot start workflow runs.
11110
11111 - `type: "disabled"`
11112
11113### Beta Managed Agents Multiagent Workflows Enabled
11114
11115- `BetaManagedAgentsMultiagentWorkflowsEnabled object`
11116
11117 The agent can start workflow runs.
11118
11119 - `type: "enabled"`
11120
11121 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
11122
11123 Whether a run's plan can define inline agents, which are not saved.
11124
11125 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
11126
11127 The agent can define inline agents.
11128
11129 - `type: "enabled"`
11130
11131 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
11132
11133 The agent cannot define inline agents.
11134
11135 - `type: "disabled"`
11136
11137 - `predefined_agents: array of BetaManagedAgentsAgentReference`
11138
11139 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
11140
11141 - `type: "agent"`
11142
11143 - `id: string`
11144
11145 - `version: number`
11146
11147 format: int32
11148
11149### Beta Managed Agents Multiagent Workflows Enabled Params
11150
11151- `BetaManagedAgentsMultiagentWorkflowsEnabledParams object`
11152
11153 The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
11154
11155 - `type: "enabled"`
11156
11157 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
11158
11159 Whether a run's plan can define inline agents. Defaults to enabled.
11160
11161 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
11162
11163 The agent can define inline agents.
11164
11165 - `type: "enabled"`
11166
11167 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
11168
11169 The agent cannot define inline agents.
11170
11171 - `type: "disabled"`
11172
11173 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
11174
11175 Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other.
11176
11177 - `string`
11178
11179 - `BetaManagedAgentsAgentParams object`
11180
11181 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
11182
11183 - `type: "agent"`
11184
11185 - `id: string`
11186
11187 The `agent` ID.
11188
11189 minLength: 1, maxLength: 128
11190
11191 - `version: optional number`
11192
11193 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
11194
11195 format: int32
11196
11197 - `BetaManagedAgentsMultiagentSelfParams object`
11198
11199 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
11200
11201 - `type: "self"`
11202
11203### Beta Managed Agents Multiagent Workflows Params
11204
11205- `BetaManagedAgentsMultiagentWorkflowsParams = BetaManagedAgentsMultiagentWorkflowsEnabledParams or BetaManagedAgentsMultiagentWorkflowsDisabledParams`
11206
11207 Whether the agent can start workflow runs.
11208
11209 - `BetaManagedAgentsMultiagentWorkflowsEnabledParams object`
11210
11211 The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
11212
11213 - `type: "enabled"`
11214
11215 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
11216
11217 Whether a run's plan can define inline agents. Defaults to enabled.
11218
11219 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
11220
11221 The agent can define inline agents.
11222
11223 - `type: "enabled"`
11224
11225 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
11226
11227 The agent cannot define inline agents.
11228
11229 - `type: "disabled"`
11230
11231 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
11232
11233 Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other.
11234
11235 - `string`
11236
11237 - `BetaManagedAgentsAgentParams object`
11238
11239 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
11240
11241 - `type: "agent"`
11242
11243 - `id: string`
11244
11245 The `agent` ID.
11246
11247 minLength: 1, maxLength: 128
11248
11249 - `version: optional number`
11250
11251 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
11252
11253 format: int32
11254
11255 - `BetaManagedAgentsMultiagentSelfParams object`
11256
11257 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
11258
11259 - `type: "self"`
11260
11261 - `BetaManagedAgentsMultiagentWorkflowsDisabledParams object`
11262
11263 The agent cannot start workflow runs.
11264
11265 - `type: "disabled"`
11266
11267### Beta Managed Agents Multiagent20261001
11268
11269- `BetaManagedAgentsMultiagent20261001 object`
11270
11271 Resolved multiagent configuration with three members, each enabled or disabled on its own.
11272
11273 - `type: "multiagent_20261001"`
11274
11275 - `advisor: BetaManagedAgentsMultiagentAdvisor`
11276
11277 Whether the session's primary thread can consult an advisor model.
11278
11279 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
11280
11281 The session's primary thread can consult `model` mid-turn.
11282
11283 - `type: "enabled"`
11284
11285 - `model: string`
11286
11287 The advisor model id.
11288
11289 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
11290
11291 The agent has no advisor.
11292
11293 - `type: "disabled"`
11294
11295 - `subagents: BetaManagedAgentsMultiagentSubagents`
11296
11297 Whether the agent can spawn session threads.
11298
11299 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
11300
11301 The agent can spawn session threads.
11302
11303 - `type: "enabled"`
11304
11305 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
11306
11307 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
11308
11309 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
11310
11311 The agent can define inline agents.
11312
11313 - `type: "enabled"`
11314
11315 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
11316
11317 The agent cannot define inline agents.
11318
11319 - `type: "disabled"`
11320
11321 - `predefined_agents: array of BetaManagedAgentsAgentReference`
11322
11323 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
11324
11325 - `type: "agent"`
11326
11327 - `id: string`
11328
11329 - `version: number`
11330
11331 format: int32
11332
11333 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
11334
11335 The agent cannot spawn session threads.
11336
11337 - `type: "disabled"`
11338
11339 - `workflows: BetaManagedAgentsMultiagentWorkflows`
11340
11341 Whether the agent can start workflow runs.
11342
11343 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
11344
11345 The agent can start workflow runs.
11346
11347 - `type: "enabled"`
11348
11349 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
11350
11351 Whether a run's plan can define inline agents, which are not saved.
11352
11353 - `predefined_agents: array of BetaManagedAgentsAgentReference`
11354
11355 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
11356
11357 - `type: "agent"`
11358
11359 - `id: string`
11360
11361 - `version: number`
11362
11363 format: int32
11364
11365 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
11366
11367 The agent cannot start workflow runs.
11368
11369 - `type: "disabled"`
11370
11371### Beta Managed Agents Multiagent20261001 Params
11372
11373- `BetaManagedAgentsMultiagent20261001Params object`
11374
11375 Multiagent configuration with three members, each enabled or disabled on its own. On an update, if the agent's stored `multiagent` also has type `multiagent_20261001`, this configuration is merged into the stored one, level by level, instead of replacing it. A key that the update omits keeps its stored value. A key sent as null takes its default, on create as well, so `"workflows": null` enables workflows. An object sent with a `type` other than the stored one replaces the stored object, and the keys that it omits take their defaults. A `predefined_agents` list that is sent replaces the stored list. Every object that is sent needs its `type`, and an enabled `advisor` needs its `model`. Other validation applies to the merged result.
11376
11377 - `type: "multiagent_20261001"`
11378
11379 - `advisor: optional BetaManagedAgentsMultiagentAdvisorParams or null`
11380
11381 Whether the session's primary thread can consult an advisor model. Defaults to disabled.
11382
11383 - `BetaManagedAgentsMultiagentAdvisorEnabledParams object`
11384
11385 The session's primary thread can consult `model` mid-turn.
11386
11387 - `type: "enabled"`
11388
11389 - `model: string`
11390
11391 A Claude model id. The model must be permitted as an advisor for this agent's model.
11392
11393 minLength: 1, maxLength: 256
11394
11395 - `BetaManagedAgentsMultiagentAdvisorDisabledParams object`
11396
11397 The agent has no advisor.
11398
11399 - `type: "disabled"`
11400
11401 - `subagents: optional BetaManagedAgentsMultiagentSubagentsParams or null`
11402
11403 Whether the agent can spawn session threads. Defaults to enabled.
11404
11405 - `BetaManagedAgentsMultiagentSubagentsEnabledParams object`
11406
11407 The agent can spawn session threads. Each thread runs a predefined agent, which is a saved agent in `predefined_agents`, or an inline agent, which the agent defines when it spawns the thread and which is not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
11408
11409 - `type: "enabled"`
11410
11411 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
11412
11413 Whether the agent can define inline agents when it spawns session threads. Defaults to enabled.
11414
11415 - `BetaManagedAgentsMultiagentInlineAgentsEnabledParams object`
11416
11417 The agent can define inline agents.
11418
11419 - `type: "enabled"`
11420
11421 - `BetaManagedAgentsMultiagentInlineAgentsDisabledParams object`
11422
11423 The agent cannot define inline agents.
11424
11425 - `type: "disabled"`
11426
11427 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
11428
11429 Predefined agents that this agent can spawn as session threads. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `workflows.predefined_agents`, and an agent in one list is not added to the other.
11430
11431 - `string`
11432
11433 - `BetaManagedAgentsAgentParams object`
11434
11435 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
11436
11437 - `type: "agent"`
11438
11439 - `id: string`
11440
11441 The `agent` ID.
11442
11443 minLength: 1, maxLength: 128
11444
11445 - `version: optional number`
11446
11447 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
11448
11449 format: int32
11450
11451 - `BetaManagedAgentsMultiagentSelfParams object`
11452
11453 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
11454
11455 - `type: "self"`
11456
11457 - `BetaManagedAgentsMultiagentSubagentsDisabledParams object`
11458
11459 The agent cannot spawn session threads.
11460
11461 - `type: "disabled"`
11462
11463 - `workflows: optional BetaManagedAgentsMultiagentWorkflowsParams or null`
11464
11465 Whether the agent can start workflow runs. Defaults to enabled.
11466
11467 - `BetaManagedAgentsMultiagentWorkflowsEnabledParams object`
11468
11469 The agent can start workflow runs. Each run follows a plan, a program that the agent writes. A plan can use predefined agents, which are the saved agents in `predefined_agents`, and inline agents, which it defines itself and which are not saved. If `inline_agents` is disabled, `predefined_agents` must name at least one agent.
11470
11471 - `type: "enabled"`
11472
11473 - `inline_agents: optional BetaManagedAgentsMultiagentInlineAgentsParams or null`
11474
11475 Whether a run's plan can define inline agents. Defaults to enabled.
11476
11477 - `predefined_agents: optional array of BetaManagedAgentsMultiagentPredefinedAgentParams or null`
11478
11479 Predefined agents that a run's plan can use. At most 20. Defaults to null. Null and an empty list both mean no predefined agents. This list is separate from `subagents.predefined_agents`, and an agent in one list is not added to the other.
11480
11481 - `string`
11482
11483 - `BetaManagedAgentsAgentParams object`
11484
11485 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
11486
11487 - `BetaManagedAgentsMultiagentSelfParams object`
11488
11489 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
11490
11491 - `BetaManagedAgentsMultiagentWorkflowsDisabledParams object`
11492
11493 The agent cannot start workflow runs.
11494
11495 - `type: "disabled"`
11496
973911497### Beta Managed Agents Read Tool Config
974011498
974111499- `BetaManagedAgentsReadToolConfig object`
from line 11642
988411642
988511643 - `"claude-haiku-4-5"`
988611644
9887 Fastest model with near-frontier intelligence
9888
988911645 - `"claude-haiku-4-5-20251001"`
989011646
9891 Fastest model with near-frontier intelligence
9892
989311647 - `"claude-opus-4-5"`
989411648
989511649 Powerful intelligence for long-running agents and coding
from line 13420
1166613420
1166713421 - `"claude-haiku-4-5"`
1166813422
11669 Fastest model with near-frontier intelligence
11670
1167113423 - `"claude-haiku-4-5-20251001"`
1167213424
11673 Fastest model with near-frontier intelligence
11674
1167513425 - `"claude-opus-4-5"`
1167613426
1167713427 Powerful intelligence for long-running agents and coding
from line 13494
1174413494
1174513495 Multiagent orchestration configuration. Null when the agent is single-threaded.
1174613496
11747 - `type: "coordinator"`
11748
11749 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
11750
11751 Agents the coordinator may spawn as session threads, each resolved to a specific version.
11752
11753 - `BetaManagedAgentsAgentReference object`
11754
11755 A resolved agent reference with a concrete version.
11756
11757 - `type: "agent"`
11758
11759 - `id: string`
11760
11761 - `version: number`
11762
11763 format: int32
11764
11765 - `BetaManagedAgentsAdvisor object`
11766
11767 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
11768
11769 - `type: "advisor"`
11770
11771 - `model: string`
11772
11773 The advisor model id.
13497 - `BetaManagedAgentsMultiagentCoordinator object`
13498
13499 Resolved coordinator topology with a concrete agent roster.
13500
13501 - `type: "coordinator"`
13502
13503 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
13504
13505 Agents the coordinator may spawn as session threads, each resolved to a specific version.
13506
13507 - `BetaManagedAgentsAgentReference object`
13508
13509 A resolved agent reference with a concrete version.
13510
13511 - `type: "agent"`
13512
13513 - `id: string`
13514
13515 - `version: number`
13516
13517 format: int32
13518
13519 - `BetaManagedAgentsAdvisor object`
13520
13521 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
13522
13523 - `type: "advisor"`
13524
13525 - `model: string`
13526
13527 The advisor model id.
13528
13529 - `BetaManagedAgentsMultiagent20261001 object`
13530
13531 Resolved multiagent configuration with three members, each enabled or disabled on its own.
13532
13533 - `type: "multiagent_20261001"`
13534
13535 - `advisor: BetaManagedAgentsMultiagentAdvisor`
13536
13537 Whether the session's primary thread can consult an advisor model.
13538
13539 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
13540
13541 The session's primary thread can consult `model` mid-turn.
13542
13543 - `type: "enabled"`
13544
13545 - `model: string`
13546
13547 The advisor model id.
13548
13549 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
13550
13551 The agent has no advisor.
13552
13553 - `type: "disabled"`
13554
13555 - `subagents: BetaManagedAgentsMultiagentSubagents`
13556
13557 Whether the agent can spawn session threads.
13558
13559 - `BetaManagedAgentsMultiagentSubagentsEnabled object`
13560
13561 The agent can spawn session threads.
13562
13563 - `type: "enabled"`
13564
13565 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
13566
13567 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
13568
13569 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
13570
13571 The agent can define inline agents.
13572
13573 - `type: "enabled"`
13574
13575 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
13576
13577 The agent cannot define inline agents.
13578
13579 - `type: "disabled"`
13580
13581 - `predefined_agents: array of BetaManagedAgentsAgentReference`
13582
13583 Predefined agents, which are saved agents that this agent can spawn as session threads, each resolved to a specific version.
13584
13585 - `type: "agent"`
13586
13587 - `id: string`
13588
13589 - `version: number`
13590
13591 format: int32
13592
13593 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
13594
13595 The agent cannot spawn session threads.
13596
13597 - `type: "disabled"`
13598
13599 - `workflows: BetaManagedAgentsMultiagentWorkflows`
13600
13601 Whether the agent can start workflow runs.
13602
13603 - `BetaManagedAgentsMultiagentWorkflowsEnabled object`
13604
13605 The agent can start workflow runs.
13606
13607 - `type: "enabled"`
13608
13609 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
13610
13611 Whether a run's plan can define inline agents, which are not saved.
13612
13613 - `predefined_agents: array of BetaManagedAgentsAgentReference`
13614
13615 Predefined agents, which are saved agents that a run's plan can use, each resolved to a specific version.
13616
13617 - `type: "agent"`
13618
13619 - `id: string`
13620
13621 - `version: number`
13622
13623 format: int32
13624
13625 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
13626
13627 The agent cannot start workflow runs.
13628
13629 - `type: "disabled"`
1177413630
1177513631 - `name: string`
1177613632
from line 14140
1228414140 "speed": "standard"
1228514141 },
1228614142 "multiagent": {
12287 "agents": [
12288 {
12289 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
12290 "type": "agent",
12291 "version": 1
12292 }
12293 ],
12294 "type": "coordinator"
14143 "advisor": {
14144 "type": "disabled"
14145 },
14146 "subagents": {
14147 "inline_agents": {
14148 "type": "enabled"
14149 },
14150 "predefined_agents": [
14151 {
14152 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
14153 "type": "agent",
14154 "version": 1
14155 }
14156 ],
14157 "type": "enabled"
14158 },
14159 "type": "multiagent_20261001",
14160 "workflows": {
14161 "inline_agents": {
14162 "type": "enabled"
14163 },
14164 "predefined_agents": [
14165 {
14166 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
14167 "type": "agent",
14168 "version": 1
14169 }
14170 ],
14171 "type": "enabled"
14172 }
1229514173 },
1229614174 "name": "My First Agent",
1229714175 "skills": [
1229814176
No line in this hunk matches that.