Create Agent changedapi/beta/agents/create
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+156added
Lines−243removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits25to this page, all time
# Create Agent ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Create Agent ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Create Agent
3url: https://platform.claude.com/docs/en/api/beta/agents/create
4---
1# Create Agent
52
6## Create Agent
3**POST** `/v1/agents`
74
8**post** `/v1/agents`
9
105Create Agent
116
12### Header Parameters
7## Headers
138
149- `"anthropic-beta": optional array of AnthropicBeta`
1510
from line 82
8782
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984
90### Body Parameters
85## Body parameters
9186
9287- `model: BetaManagedAgentsModel or BetaManagedAgentsModelConfigParams`
9388
from line 154
159154
160155 - `string`
161156
162 - `BetaManagedAgentsModelConfigParams object { id, effort, inference_geo, speed }`
157 - `BetaManagedAgentsModelConfigParams object`
163158
164159 An object that defines additional configuration control over model use
165160
from line 182
187182
188183 - `"max"`
189184
190 - `BetaManagedAgentsEffortLow object { type }`
185 - `BetaManagedAgentsEffortLow object`
191186
192187 Low effort. Favors latency over reasoning depth.
193188
194189 - `type: "low"`
195190
196 - `"low"`
191 - `BetaManagedAgentsEffortMedium object`
197192
198 - `BetaManagedAgentsEffortMedium object { type }`
199
200193 Medium effort. Balances latency and reasoning depth.
201194
202195 - `type: "medium"`
203196
204 - `"medium"`
197 - `BetaManagedAgentsEffortHigh object`
205198
206 - `BetaManagedAgentsEffortHigh object { type }`
207
208199 High effort. Favors reasoning depth.
209200
210201 - `type: "high"`
211202
212 - `"high"`
203 - `BetaManagedAgentsEffortXhigh object`
213204
214 - `BetaManagedAgentsEffortXhigh object { type }`
215
216205 Extra-high effort. Not all models accept this level.
217206
218207 - `type: "xhigh"`
219208
220 - `"xhigh"`
209 - `BetaManagedAgentsEffortMax object`
221210
222 - `BetaManagedAgentsEffortMax object { type }`
223
224211 Maximum effort. Favors reasoning depth over latency.
225212
226213 - `type: "max"`
227214
228 - `"max"`
229
230215 - `inference_geo: optional string or null`
231216
232217 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo. On update, `model` is whole-object replacement — omitting inference_geo clears it.
from line 228
243228
244229 Human-readable name for the agent.
245230
231 minLength: 1, maxLength: 256
232
246233- `description: optional string or null`
247234
248235 Description of what the agent does.
249236
237 maxLength: 2048
238
250239- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams`
251240
252241 MCP servers this agent connects to. Maximum 20. Names must be unique within the array. Every server must be referenced by an `mcp_toolset` in `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
from line 244
255244
256245 Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.
257246
247 minLength: 1, maxLength: 255
248
258249 - `type: "url"`
259250
260 - `"url"`
261
262251 - `url: string`
263252
264253 Endpoint URL for the MCP server.
265254
255 maxLength: 2048
256
266257- `metadata: optional map[string]`
267258
268259 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
from line 268
277268
278269 - `string`
279270
280 - `BetaManagedAgentsAgentParams object { id, type, version }`
271 - `BetaManagedAgentsAgentParams object`
281272
282273 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
283274
from line 276
285276
286277 The `agent` ID.
287278
279 minLength: 1, maxLength: 128
280
288281 - `type: "agent"`
289282
290 - `"agent"`
291
292283 - `version: optional number`
293284
294285 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
295286
296 - `BetaManagedAgentsMultiagentSelfParams object { type }`
287 format: int32
297288
289 - `BetaManagedAgentsMultiagentSelfParams object`
290
298291 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
299292
300293 - `type: "self"`
301294
302 - `"self"`
295 - `BetaManagedAgentsAdvisorParams object`
303296
304 - `BetaManagedAgentsAdvisorParams object { model, type }`
305
306297 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`.
307298
308299 - `model: string`
from line 300
309300
310301 A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.
311302
303 minLength: 1, maxLength: 256
304
312305 - `type: "advisor"`
313306
314 - `"advisor"`
315
316307 - `type: "coordinator"`
317308
318 - `"coordinator"`
319
320309- `skills: optional array of BetaManagedAgentsSkillParams`
321310
322311 Skills available to the agent.
323312
324 - `BetaManagedAgentsAnthropicSkillParams object { skill_id, type, version }`
313 - `BetaManagedAgentsAnthropicSkillParams object`
325314
326315 An Anthropic-managed skill.
327316
from line 318
329318
330319 Identifier of the Anthropic skill (e.g., "xlsx").
331320
321 minLength: 1, maxLength: 64
322
332323 - `type: "anthropic"`
333324
334 - `"anthropic"`
335
336325 - `version: optional string or null`
337326
338327 Version to pin. Defaults to latest if omitted.
339328
340 - `BetaManagedAgentsCustomSkillParams object { skill_id, type, version }`
329 minLength: 1, maxLength: 64
341330
331 - `BetaManagedAgentsCustomSkillParams object`
332
342333 A user-created custom skill.
343334
344335 - `skill_id: string`
from line 336
345336
346337 Tagged ID of the custom skill (e.g., "skill_01XJ5...").
347338
339 minLength: 1, maxLength: 64
340
348341 - `type: "custom"`
349342
350 - `"custom"`
351
352343 - `version: optional string or null`
353344
354345 Version to pin. Defaults to latest if omitted.
355346
347 minLength: 1, maxLength: 64
348
356349- `system: optional string or null`
357350
358351 System prompt for the agent.
359352
353 maxLength: 100000
354
360355- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams`
361356
362357 Tool configurations available to the agent. Maximum of 128 tools across all toolsets allowed.
363358
364 - `BetaManagedAgentsAgentToolset20260401Params object { type, configs, default_config }`
359 - `BetaManagedAgentsAgentToolset20260401Params object`
365360
366361 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
367362
368363 - `type: "agent_toolset_20260401"`
369364
370 - `"agent_toolset_20260401"`
371
372365 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
373366
374367 Per-tool configuration overrides.
375368
376 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
369 - `BetaManagedAgentsBashToolConfigParams object`
377370
378371 Configuration override for the bash tool.
379372
from line 374
381374
382375 Must be "bash".
383376
384 - `"bash"`
385
386377 - `enabled: optional boolean or null`
387378
388379 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 382
391382
392383 Permission policy for tool execution.
393384
394 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
385 - `BetaManagedAgentsAlwaysAllowPolicy object`
395386
396387 Tool calls are automatically approved without user confirmation.
397388
398389 - `type: "always_allow"`
399390
400 - `"always_allow"`
391 - `BetaManagedAgentsAlwaysAskPolicy object`
401392
402 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
403
404393 Tool calls require user confirmation before execution.
405394
406395 - `type: "always_ask"`
407396
408 - `"always_ask"`
409
410397 - `type: optional "bash"`
411398
412 - `"bash"`
399 - `BetaManagedAgentsEditToolConfigParams object`
413400
414 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
415
416401 Configuration override for the edit tool.
417402
418403 - `name: "edit"`
from line 404
419404
420405 Must be "edit".
421406
422 - `"edit"`
423
424407 - `enabled: optional boolean or null`
425408
426409 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 412
429412
430413 Permission policy for tool execution.
431414
432 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
415 - `BetaManagedAgentsAlwaysAllowPolicy object`
433416
434417 Tool calls are automatically approved without user confirmation.
435418
436 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
419 - `BetaManagedAgentsAlwaysAskPolicy object`
437420
438421 Tool calls require user confirmation before execution.
439422
440423 - `type: optional "edit"`
441424
442 - `"edit"`
425 - `BetaManagedAgentsReadToolConfigParams object`
443426
444 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
445
446427 Configuration override for the read tool.
447428
448429 - `name: "read"`
from line 430
449430
450431 Must be "read".
451432
452 - `"read"`
453
454433 - `enabled: optional boolean or null`
455434
456435 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 438
459438
460439 Permission policy for tool execution.
461440
462 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
441 - `BetaManagedAgentsAlwaysAllowPolicy object`
463442
464443 Tool calls are automatically approved without user confirmation.
465444
466 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
445 - `BetaManagedAgentsAlwaysAskPolicy object`
467446
468447 Tool calls require user confirmation before execution.
469448
470449 - `type: optional "read"`
471450
472 - `"read"`
451 - `BetaManagedAgentsWriteToolConfigParams object`
473452
474 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
475
476453 Configuration override for the write tool.
477454
478455 - `name: "write"`
from line 456
479456
480457 Must be "write".
481458
482 - `"write"`
483
484459 - `enabled: optional boolean or null`
485460
486461 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 464
489464
490465 Permission policy for tool execution.
491466
492 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
467 - `BetaManagedAgentsAlwaysAllowPolicy object`
493468
494469 Tool calls are automatically approved without user confirmation.
495470
496 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
471 - `BetaManagedAgentsAlwaysAskPolicy object`
497472
498473 Tool calls require user confirmation before execution.
499474
500475 - `type: optional "write"`
501476
502 - `"write"`
477 - `BetaManagedAgentsGlobToolConfigParams object`
503478
504 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
505
506479 Configuration override for the glob tool.
507480
508481 - `name: "glob"`
from line 482
509482
510483 Must be "glob".
511484
512 - `"glob"`
513
514485 - `enabled: optional boolean or null`
515486
516487 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 490
519490
520491 Permission policy for tool execution.
521492
522 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
493 - `BetaManagedAgentsAlwaysAllowPolicy object`
523494
524495 Tool calls are automatically approved without user confirmation.
525496
526 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
497 - `BetaManagedAgentsAlwaysAskPolicy object`
527498
528499 Tool calls require user confirmation before execution.
529500
530501 - `type: optional "glob"`
531502
532 - `"glob"`
503 - `BetaManagedAgentsGrepToolConfigParams object`
533504
534 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
535
536505 Configuration override for the grep tool.
537506
538507 - `name: "grep"`
from line 508
539508
540509 Must be "grep".
541510
542 - `"grep"`
543
544511 - `enabled: optional boolean or null`
545512
546513 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 516
549516
550517 Permission policy for tool execution.
551518
552 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
519 - `BetaManagedAgentsAlwaysAllowPolicy object`
553520
554521 Tool calls are automatically approved without user confirmation.
555522
556 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
523 - `BetaManagedAgentsAlwaysAskPolicy object`
557524
558525 Tool calls require user confirmation before execution.
559526
560527 - `type: optional "grep"`
561528
562 - `"grep"`
529 - `BetaManagedAgentsWebFetchToolConfigParams object`
563530
564 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
565
566531 Configuration override for the web_fetch tool.
567532
568533 - `name: "web_fetch"`
from line 534
569534
570535 Must be "web_fetch".
571536
572 - `"web_fetch"`
573
574537 - `allowed_domains: optional array of string`
575538
576539 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.
from line 550
587550
588551 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
589552
553 format: int32
554
590555 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
591556
592557 Permission policy for tool execution.
593558
594 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
559 - `BetaManagedAgentsAlwaysAllowPolicy object`
595560
596561 Tool calls are automatically approved without user confirmation.
597562
598 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
563 - `BetaManagedAgentsAlwaysAskPolicy object`
599564
600565 Tool calls require user confirmation before execution.
601566
602567 - `type: optional "web_fetch"`
603568
604 - `"web_fetch"`
569 - `BetaManagedAgentsWebSearchToolConfigParams object`
605570
606 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
607
608571 Configuration override for the web_search tool.
609572
610573 - `name: "web_search"`
from line 574
611574
612575 Must be "web_search".
613576
614 - `"web_search"`
615
616577 - `allowed_domains: optional array of string`
617578
618579 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.
from line 590
629590
630591 Permission policy for tool execution.
631592
632 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
593 - `BetaManagedAgentsAlwaysAllowPolicy object`
633594
634595 Tool calls are automatically approved without user confirmation.
635596
636 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
597 - `BetaManagedAgentsAlwaysAskPolicy object`
637598
638599 Tool calls require user confirmation before execution.
639600
640601 - `type: optional "web_search"`
641602
642 - `"web_search"`
643
644603 - `user_location: optional BetaManagedAgentsUserLocation or null`
645604
646605 Approximate user location for search result localization.
from line 608
649608
650609 Location precision. Only "approximate" is supported.
651610
652 - `"approximate"`
653
654611 - `city: optional string or null`
655612
656613 City name.
657614
615 minLength: 1, maxLength: 255
616
658617 - `country: optional string or null`
659618
660619 Two-letter ISO 3166-1 country code, uppercase.
from line 622
663622
664623 Region or state name.
665624
625 minLength: 1, maxLength: 255
626
666627 - `timezone: optional string or null`
667628
668629 IANA timezone identifier, e.g. "America/Los_Angeles".
669630
631 minLength: 1, maxLength: 255
632
670633 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
671634
672635 Default configuration for all tools in a toolset.
from line 642
679642
680643 Permission policy for tool execution.
681644
682 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
645 - `BetaManagedAgentsAlwaysAllowPolicy object`
683646
684647 Tool calls are automatically approved without user confirmation.
685648
686 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
649 - `BetaManagedAgentsAlwaysAskPolicy object`
687650
688651 Tool calls require user confirmation before execution.
689652
690 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
653 - `BetaManagedAgentsMCPToolsetParams object`
691654
692655 Configuration for tools from an MCP server defined in `mcp_servers`.
693656
from line 658
695658
696659 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
697660
661 minLength: 1, maxLength: 255
662
698663 - `type: "mcp_toolset"`
699664
700 - `"mcp_toolset"`
701
702665 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
703666
704667 Per-tool configuration overrides.
from line 670
707670
708671 Name of the MCP tool to configure. 1-128 characters.
709672
673 minLength: 1, maxLength: 128
674
710675 - `enabled: optional boolean or null`
711676
712677 Whether this tool is enabled. Overrides the `default_config` setting.
from line 680
715680
716681 Permission policy for tool execution.
717682
718 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
683 - `BetaManagedAgentsAlwaysAllowPolicy object`
719684
720685 Tool calls are automatically approved without user confirmation.
721686
722 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
687 - `BetaManagedAgentsAlwaysAskPolicy object`
723688
724689 Tool calls require user confirmation before execution.
725690
from line 700
735700
736701 Permission policy for tool execution.
737702
738 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
703 - `BetaManagedAgentsAlwaysAllowPolicy object`
739704
740705 Tool calls are automatically approved without user confirmation.
741706
742 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
707 - `BetaManagedAgentsAlwaysAskPolicy object`
743708
744709 Tool calls require user confirmation before execution.
745710
746 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
711 - `BetaManagedAgentsCustomToolParams object`
747712
748713 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.
749714
from line 716
751716
752717 Description of what the tool does, shown to the agent to help it decide when to use the tool.
753718
719 minLength: 1
720
754721 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
755722
756723 JSON Schema for custom tool input parameters.
from line 724
757724
758725 - `type: "object"`
759726
760 - `"object"`
761
762727 - `properties: optional map[unknown] or null`
763728
764729 - `required: optional array of string or null`
from line 732
767732
768733 Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.
769734
735 minLength: 1, maxLength: 128
736
770737 - `type: "custom"`
771738
772 - `"custom"`
739## Returns
773740
774### Returns
741- `BetaManagedAgentsAgent object`
775742
776- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`
777
778743 A Managed Agents `agent`.
779744
780745 - `id: string`
from line 748
783748
784749 A timestamp in RFC 3339 format
785750
751 format: date-time
752
786753 - `created_at: string`
787754
788755 A timestamp in RFC 3339 format
789756
757 format: date-time
758
790759 - `description: string or null`
791760
792761 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
from line 764
795764
796765 - `type: "url"`
797766
798 - `"url"`
799
800767 - `url: string`
801768
802769 - `metadata: map[string]`
from line 842
875842
876843 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
877844
878 - `BetaManagedAgentsEffortLow object { type }`
845 - `BetaManagedAgentsEffortLow object`
879846
880847 Low effort. Favors latency over reasoning depth.
881848
882849 - `type: "low"`
883850
884 - `"low"`
851 - `BetaManagedAgentsEffortMedium object`
885852
886 - `BetaManagedAgentsEffortMedium object { type }`
887
888853 Medium effort. Balances latency and reasoning depth.
889854
890855 - `type: "medium"`
891856
892 - `"medium"`
857 - `BetaManagedAgentsEffortHigh object`
893858
894 - `BetaManagedAgentsEffortHigh object { type }`
895
896859 High effort. Favors reasoning depth.
897860
898861 - `type: "high"`
899862
900 - `"high"`
863 - `BetaManagedAgentsEffortXhigh object`
901864
902 - `BetaManagedAgentsEffortXhigh object { type }`
903
904865 Extra-high effort. Not all models accept this level.
905866
906867 - `type: "xhigh"`
907868
908 - `"xhigh"`
869 - `BetaManagedAgentsEffortMax object`
909870
910 - `BetaManagedAgentsEffortMax object { type }`
911
912871 Maximum effort. Favors reasoning depth over latency.
913872
914873 - `type: "max"`
915874
916 - `"max"`
917
918875 - `inference_geo: optional string`
919876
920877 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 892
935892
936893 Agents the coordinator may spawn as session threads, each resolved to a specific version.
937894
938 - `BetaManagedAgentsAgentReference object { id, type, version }`
895 - `BetaManagedAgentsAgentReference object`
939896
940897 A resolved agent reference with a concrete version.
941898
from line 900
943900
944901 - `type: "agent"`
945902
946 - `"agent"`
947
948903 - `version: number`
949904
950 - `BetaManagedAgentsAdvisor object { model, type }`
905 format: int32
951906
907 - `BetaManagedAgentsAdvisor object`
908
952909 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
953910
954911 - `model: string`
from line 914
957914
958915 - `type: "advisor"`
959916
960 - `"advisor"`
961
962917 - `type: "coordinator"`
963918
964 - `"coordinator"`
965
966919 - `name: string`
967920
968921 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
969922
970 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
923 - `BetaManagedAgentsAnthropicSkill object`
971924
972925 A resolved Anthropic-managed skill.
973926
from line 928
975928
976929 - `type: "anthropic"`
977930
978 - `"anthropic"`
979
980931 - `version: string`
981932
982 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
933 - `BetaManagedAgentsCustomSkill object`
983934
984935 A resolved user-created custom skill.
985936
from line 938
987938
988939 - `type: "custom"`
989940
990 - `"custom"`
991
992941 - `version: string`
993942
994943 - `system: string or null`
from line 944
995944
996945 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
997946
998 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
947 - `BetaManagedAgentsAgentToolset20260401 object`
999948
1000949 - `configs: array of BetaManagedAgentsAgentToolConfig`
1001950
1002 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
951 - `BetaManagedAgentsBashToolConfig object`
1003952
1004953 Configuration for the bash tool.
1005954
from line 956
1007956
1008957 - `name: "bash"`
1009958
1010 - `"bash"`
1011
1012959 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1013960
1014961 Permission policy for tool execution.
1015962
1016 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
963 - `BetaManagedAgentsAlwaysAllowPolicy object`
1017964
1018965 Tool calls are automatically approved without user confirmation.
1019966
1020967 - `type: "always_allow"`
1021968
1022 - `"always_allow"`
969 - `BetaManagedAgentsAlwaysAskPolicy object`
1023970
1024 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1025
1026971 Tool calls require user confirmation before execution.
1027972
1028973 - `type: "always_ask"`
1029974
1030 - `"always_ask"`
1031
1032975 - `type: "bash"`
1033976
1034 - `"bash"`
977 - `BetaManagedAgentsEditToolConfig object`
1035978
1036 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
1037
1038979 Configuration for the edit tool.
1039980
1040981 - `enabled: boolean`
from line 982
1041982
1042983 - `name: "edit"`
1043984
1044 - `"edit"`
1045
1046985 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1047986
1048987 Permission policy for tool execution.
1049988
1050 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
989 - `BetaManagedAgentsAlwaysAllowPolicy object`
1051990
1052991 Tool calls are automatically approved without user confirmation.
1053992
1054 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
993 - `BetaManagedAgentsAlwaysAskPolicy object`
1055994
1056995 Tool calls require user confirmation before execution.
1057996
1058997 - `type: "edit"`
1059998
1060 - `"edit"`
999 - `BetaManagedAgentsReadToolConfig object`
10611000
1062 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
1063
10641001 Configuration for the read tool.
10651002
10661003 - `enabled: boolean`
from line 1004
10671004
10681005 - `name: "read"`
10691006
1070 - `"read"`
1071
10721007 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
10731008
10741009 Permission policy for tool execution.
10751010
1076 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1011 - `BetaManagedAgentsAlwaysAllowPolicy object`
10771012
10781013 Tool calls are automatically approved without user confirmation.
10791014
1080 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1015 - `BetaManagedAgentsAlwaysAskPolicy object`
10811016
10821017 Tool calls require user confirmation before execution.
10831018
10841019 - `type: "read"`
10851020
1086 - `"read"`
1021 - `BetaManagedAgentsWriteToolConfig object`
10871022
1088 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
1089
10901023 Configuration for the write tool.
10911024
10921025 - `enabled: boolean`
from line 1026
10931026
10941027 - `name: "write"`
10951028
1096 - `"write"`
1097
10981029 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
10991030
11001031 Permission policy for tool execution.
11011032
1102 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1033 - `BetaManagedAgentsAlwaysAllowPolicy object`
11031034
11041035 Tool calls are automatically approved without user confirmation.
11051036
1106 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1037 - `BetaManagedAgentsAlwaysAskPolicy object`
11071038
11081039 Tool calls require user confirmation before execution.
11091040
11101041 - `type: "write"`
11111042
1112 - `"write"`
1043 - `BetaManagedAgentsGlobToolConfig object`
11131044
1114 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
1115
11161045 Configuration for the glob tool.
11171046
11181047 - `enabled: boolean`
from line 1048
11191048
11201049 - `name: "glob"`
11211050
1122 - `"glob"`
1123
11241051 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11251052
11261053 Permission policy for tool execution.
11271054
1128 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1055 - `BetaManagedAgentsAlwaysAllowPolicy object`
11291056
11301057 Tool calls are automatically approved without user confirmation.
11311058
1132 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1059 - `BetaManagedAgentsAlwaysAskPolicy object`
11331060
11341061 Tool calls require user confirmation before execution.
11351062
11361063 - `type: "glob"`
11371064
1138 - `"glob"`
1065 - `BetaManagedAgentsGrepToolConfig object`
11391066
1140 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
1141
11421067 Configuration for the grep tool.
11431068
11441069 - `enabled: boolean`
from line 1070
11451070
11461071 - `name: "grep"`
11471072
1148 - `"grep"`
1149
11501073 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11511074
11521075 Permission policy for tool execution.
11531076
1154 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1077 - `BetaManagedAgentsAlwaysAllowPolicy object`
11551078
11561079 Tool calls are automatically approved without user confirmation.
11571080
1158 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1081 - `BetaManagedAgentsAlwaysAskPolicy object`
11591082
11601083 Tool calls require user confirmation before execution.
11611084
11621085 - `type: "grep"`
11631086
1164 - `"grep"`
1087 - `BetaManagedAgentsWebFetchToolConfig object`
11651088
1166 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
1167
11681089 Configuration for the web_fetch tool.
11691090
11701091 - `enabled: boolean`
from line 1092
11711092
11721093 - `name: "web_fetch"`
11731094
1174 - `"web_fetch"`
1175
11761095 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11771096
11781097 Permission policy for tool execution.
11791098
1180 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1099 - `BetaManagedAgentsAlwaysAllowPolicy object`
11811100
11821101 Tool calls are automatically approved without user confirmation.
11831102
1184 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1103 - `BetaManagedAgentsAlwaysAskPolicy object`
11851104
11861105 Tool calls require user confirmation before execution.
11871106
11881107 - `type: "web_fetch"`
11891108
1190 - `"web_fetch"`
1191
11921109 - `allowed_domains: optional array of string`
11931110
11941111 - `blocked_domains: optional array of string`
from line 1112
11951112
11961113 - `max_content_tokens: optional number or null`
11971114
1198 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
1115 format: int32
11991116
1117 - `BetaManagedAgentsWebSearchToolConfig object`
1118
12001119 Configuration for the web_search tool.
12011120
12021121 - `enabled: boolean`
from line 1122
12031122
12041123 - `name: "web_search"`
12051124
1206 - `"web_search"`
1207
12081125 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
12091126
12101127 Permission policy for tool execution.
12111128
1212 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1129 - `BetaManagedAgentsAlwaysAllowPolicy object`
12131130
12141131 Tool calls are automatically approved without user confirmation.
12151132
1216 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1133 - `BetaManagedAgentsAlwaysAskPolicy object`
12171134
12181135 Tool calls require user confirmation before execution.
12191136
12201137 - `type: "web_search"`
12211138
1222 - `"web_search"`
1223
12241139 - `allowed_domains: optional array of string`
12251140
12261141 - `blocked_domains: optional array of string`
from line 1148
12331148
12341149 Location precision. Only "approximate" is supported.
12351150
1236 - `"approximate"`
1237
12381151 - `city: optional string or null`
12391152
12401153 City name.
12411154
1155 minLength: 1, maxLength: 255
1156
12421157 - `country: optional string or null`
12431158
12441159 Two-letter ISO 3166-1 country code, uppercase.
from line 1162
12471162
12481163 Region or state name.
12491164
1165 minLength: 1, maxLength: 255
1166
12501167 - `timezone: optional string or null`
12511168
12521169 IANA timezone identifier, e.g. "America/Los_Angeles".
12531170
1171 minLength: 1, maxLength: 255
1172
12541173 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
12551174
12561175 Resolved default configuration for agent tools.
from line 1180
12611180
12621181 Permission policy for tool execution.
12631182
1264 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1183 - `BetaManagedAgentsAlwaysAllowPolicy object`
12651184
12661185 Tool calls are automatically approved without user confirmation.
12671186
1268 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1187 - `BetaManagedAgentsAlwaysAskPolicy object`
12691188
12701189 Tool calls require user confirmation before execution.
12711190
12721191 - `type: "agent_toolset_20260401"`
12731192
1274 - `"agent_toolset_20260401"`
1193 - `BetaManagedAgentsMCPToolset object`
12751194
1276 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
1277
12781195 - `configs: array of BetaManagedAgentsMCPToolConfig`
12791196
12801197 - `enabled: boolean`
from line 1202
12851202
12861203 Permission policy for tool execution.
12871204
1288 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1205 - `BetaManagedAgentsAlwaysAllowPolicy object`
12891206
12901207 Tool calls are automatically approved without user confirmation.
12911208
1292 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1209 - `BetaManagedAgentsAlwaysAskPolicy object`
12931210
12941211 Tool calls require user confirmation before execution.
12951212
from line 1220
13031220
13041221 Permission policy for tool execution.
13051222
1306 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1223 - `BetaManagedAgentsAlwaysAllowPolicy object`
13071224
13081225 Tool calls are automatically approved without user confirmation.
13091226
1310 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1227 - `BetaManagedAgentsAlwaysAskPolicy object`
13111228
13121229 Tool calls require user confirmation before execution.
13131230
from line 1232
13151232
13161233 - `type: "mcp_toolset"`
13171234
1318 - `"mcp_toolset"`
1235 - `BetaManagedAgentsCustomTool object`
13191236
1320 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
1321
13221237 A custom tool as returned in API responses.
13231238
13241239 - `description: string`
from line 1244
13291244
13301245 - `type: "object"`
13311246
1332 - `"object"`
1333
13341247 - `properties: optional map[unknown] or null`
13351248
13361249 - `required: optional array of string or null`
from line 1252
13391252
13401253 - `type: "custom"`
13411254
1342 - `"custom"`
1343
13441255 - `type: "agent"`
13451256
1346 - `"agent"`
1347
13481257 - `updated_at: string`
13491258
13501259 A timestamp in RFC 3339 format
13511260
1261 format: date-time
1262
13521263 - `version: number`
13531264
13541265 The agent's current version. Starts at 1 and increments when the agent is modified.
13551266
1356### Example
1267 format: int32
13571268
1358```http
1269## Example
1270
1271```bash
13591272curl https://api.anthropic.com/v1/agents \
13601273 -H 'Content-Type: application/json' \
13611274 -H 'anthropic-version: 2023-06-01' \
from line 1290
13771290 }'
13781291```
13791292
1380#### Response
1293### Response (200)
13811294
13821295```json
13831296{
No line in this hunk matches that.