Update Agent changedapi/beta/agents/update
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+159added
Lines−244removed
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
# Update Agent ## Path parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Update Agent ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Update Agent
3url: https://platform.claude.com/docs/en/api/beta/agents/update
4---
1# Update Agent
52
6## Update Agent
3**POST** `/v1/agents/{agent_id}`
74
8**post** `/v1/agents/{agent_id}`
9
105Update Agent
116
12### Path Parameters
7## Path parameters
138
149- `agent_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Body Parameters
89## Body parameters
9590
9691- `description: optional string or null`
9792
9893 Description. Omit to preserve; send empty string or null to clear.
9994
95 maxLength: 2048
96
10097- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams or null`
10198
10299 MCP servers. Full replacement. Omit to preserve; send empty array or `null` to clear. Names must be unique. Maximum 20. Every server must be referenced by an `mcp_toolset` in the agent's resulting `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).
from line 102
105102
106103 Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.
107104
105 minLength: 1, maxLength: 255
106
108107 - `type: "url"`
109108
110 - `"url"`
111
112109 - `url: string`
113110
114111 Endpoint URL for the MCP server.
115112
113 maxLength: 2048
114
116115- `metadata: optional map[string] or null`
117116
118117 Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.
from line 186
187186
188187 - `string`
189188
190 - `BetaManagedAgentsModelConfigParams object { id, effort, inference_geo, speed }`
189 - `BetaManagedAgentsModelConfigParams object`
191190
192191 An object that defines additional configuration control over model use
193192
from line 214
215214
216215 - `"max"`
217216
218 - `BetaManagedAgentsEffortLow object { type }`
217 - `BetaManagedAgentsEffortLow object`
219218
220219 Low effort. Favors latency over reasoning depth.
221220
222221 - `type: "low"`
223222
224 - `"low"`
223 - `BetaManagedAgentsEffortMedium object`
225224
226 - `BetaManagedAgentsEffortMedium object { type }`
227
228225 Medium effort. Balances latency and reasoning depth.
229226
230227 - `type: "medium"`
231228
232 - `"medium"`
229 - `BetaManagedAgentsEffortHigh object`
233230
234 - `BetaManagedAgentsEffortHigh object { type }`
235
236231 High effort. Favors reasoning depth.
237232
238233 - `type: "high"`
239234
240 - `"high"`
235 - `BetaManagedAgentsEffortXhigh object`
241236
242 - `BetaManagedAgentsEffortXhigh object { type }`
243
244237 Extra-high effort. Not all models accept this level.
245238
246239 - `type: "xhigh"`
247240
248 - `"xhigh"`
241 - `BetaManagedAgentsEffortMax object`
249242
250 - `BetaManagedAgentsEffortMax object { type }`
251
252243 Maximum effort. Favors reasoning depth over latency.
253244
254245 - `type: "max"`
255246
256 - `"max"`
257
258247 - `inference_geo: optional string or null`
259248
260249 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 266
277266
278267 - `string`
279268
280 - `BetaManagedAgentsAgentParams object { id, type, version }`
269 - `BetaManagedAgentsAgentParams object`
281270
282271 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
283272
from line 274
285274
286275 The `agent` ID.
287276
277 minLength: 1, maxLength: 128
278
288279 - `type: "agent"`
289280
290 - `"agent"`
291
292281 - `version: optional number`
293282
294283 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
295284
296 - `BetaManagedAgentsMultiagentSelfParams object { type }`
285 format: int32
297286
287 - `BetaManagedAgentsMultiagentSelfParams object`
288
298289 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.
299290
300291 - `type: "self"`
301292
302 - `"self"`
293 - `BetaManagedAgentsAdvisorParams object`
303294
304 - `BetaManagedAgentsAdvisorParams object { model, type }`
305
306295 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`.
307296
308297 - `model: string`
from line 298
309298
310299 A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.
311300
301 minLength: 1, maxLength: 256
302
312303 - `type: "advisor"`
313304
314 - `"advisor"`
315
316305 - `type: "coordinator"`
317306
318 - `"coordinator"`
319
320307- `name: optional string`
321308
322309 Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
323310
311 maxLength: 256
312
324313- `skills: optional array of BetaManagedAgentsSkillParams or null`
325314
326315 Skills. Full replacement. Omit to preserve; send empty array or null to clear.
327316
328 - `BetaManagedAgentsAnthropicSkillParams object { skill_id, type, version }`
317 - `BetaManagedAgentsAnthropicSkillParams object`
329318
330319 An Anthropic-managed skill.
331320
from line 322
333322
334323 Identifier of the Anthropic skill (e.g., "xlsx").
335324
325 minLength: 1, maxLength: 64
326
336327 - `type: "anthropic"`
337328
338 - `"anthropic"`
339
340329 - `version: optional string or null`
341330
342331 Version to pin. Defaults to latest if omitted.
343332
344 - `BetaManagedAgentsCustomSkillParams object { skill_id, type, version }`
333 minLength: 1, maxLength: 64
345334
335 - `BetaManagedAgentsCustomSkillParams object`
336
346337 A user-created custom skill.
347338
348339 - `skill_id: string`
from line 340
349340
350341 Tagged ID of the custom skill (e.g., "skill_01XJ5...").
351342
343 minLength: 1, maxLength: 64
344
352345 - `type: "custom"`
353346
354 - `"custom"`
355
356347 - `version: optional string or null`
357348
358349 Version to pin. Defaults to latest if omitted.
359350
351 minLength: 1, maxLength: 64
352
360353- `system: optional string or null`
361354
362355 System prompt. Omit to preserve; send empty string or null to clear.
363356
357 maxLength: 100000
358
364359- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams or null`
365360
366361 Tool configurations available to the agent. Full replacement. Omit to preserve; send empty array or null to clear. Maximum of 128 tools across all toolsets allowed.
367362
368 - `BetaManagedAgentsAgentToolset20260401Params object { type, configs, default_config }`
363 - `BetaManagedAgentsAgentToolset20260401Params object`
369364
370365 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.
371366
372367 - `type: "agent_toolset_20260401"`
373368
374 - `"agent_toolset_20260401"`
375
376369 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`
377370
378371 Per-tool configuration overrides.
379372
380 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
373 - `BetaManagedAgentsBashToolConfigParams object`
381374
382375 Configuration override for the bash tool.
383376
from line 378
385378
386379 Must be "bash".
387380
388 - `"bash"`
389
390381 - `enabled: optional boolean or null`
391382
392383 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 386
395386
396387 Permission policy for tool execution.
397388
398 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
389 - `BetaManagedAgentsAlwaysAllowPolicy object`
399390
400391 Tool calls are automatically approved without user confirmation.
401392
402393 - `type: "always_allow"`
403394
404 - `"always_allow"`
395 - `BetaManagedAgentsAlwaysAskPolicy object`
405396
406 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
407
408397 Tool calls require user confirmation before execution.
409398
410399 - `type: "always_ask"`
411400
412 - `"always_ask"`
413
414401 - `type: optional "bash"`
415402
416 - `"bash"`
403 - `BetaManagedAgentsEditToolConfigParams object`
417404
418 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
419
420405 Configuration override for the edit tool.
421406
422407 - `name: "edit"`
from line 408
423408
424409 Must be "edit".
425410
426 - `"edit"`
427
428411 - `enabled: optional boolean or null`
429412
430413 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 416
433416
434417 Permission policy for tool execution.
435418
436 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
419 - `BetaManagedAgentsAlwaysAllowPolicy object`
437420
438421 Tool calls are automatically approved without user confirmation.
439422
440 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
423 - `BetaManagedAgentsAlwaysAskPolicy object`
441424
442425 Tool calls require user confirmation before execution.
443426
444427 - `type: optional "edit"`
445428
446 - `"edit"`
429 - `BetaManagedAgentsReadToolConfigParams object`
447430
448 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
449
450431 Configuration override for the read tool.
451432
452433 - `name: "read"`
from line 434
453434
454435 Must be "read".
455436
456 - `"read"`
457
458437 - `enabled: optional boolean or null`
459438
460439 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 442
463442
464443 Permission policy for tool execution.
465444
466 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
445 - `BetaManagedAgentsAlwaysAllowPolicy object`
467446
468447 Tool calls are automatically approved without user confirmation.
469448
470 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
449 - `BetaManagedAgentsAlwaysAskPolicy object`
471450
472451 Tool calls require user confirmation before execution.
473452
474453 - `type: optional "read"`
475454
476 - `"read"`
455 - `BetaManagedAgentsWriteToolConfigParams object`
477456
478 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
479
480457 Configuration override for the write tool.
481458
482459 - `name: "write"`
from line 460
483460
484461 Must be "write".
485462
486 - `"write"`
487
488463 - `enabled: optional boolean or null`
489464
490465 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 468
493468
494469 Permission policy for tool execution.
495470
496 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
471 - `BetaManagedAgentsAlwaysAllowPolicy object`
497472
498473 Tool calls are automatically approved without user confirmation.
499474
500 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
475 - `BetaManagedAgentsAlwaysAskPolicy object`
501476
502477 Tool calls require user confirmation before execution.
503478
504479 - `type: optional "write"`
505480
506 - `"write"`
481 - `BetaManagedAgentsGlobToolConfigParams object`
507482
508 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
509
510483 Configuration override for the glob tool.
511484
512485 - `name: "glob"`
from line 486
513486
514487 Must be "glob".
515488
516 - `"glob"`
517
518489 - `enabled: optional boolean or null`
519490
520491 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 494
523494
524495 Permission policy for tool execution.
525496
526 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
497 - `BetaManagedAgentsAlwaysAllowPolicy object`
527498
528499 Tool calls are automatically approved without user confirmation.
529500
530 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
501 - `BetaManagedAgentsAlwaysAskPolicy object`
531502
532503 Tool calls require user confirmation before execution.
533504
534505 - `type: optional "glob"`
535506
536 - `"glob"`
507 - `BetaManagedAgentsGrepToolConfigParams object`
537508
538 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
539
540509 Configuration override for the grep tool.
541510
542511 - `name: "grep"`
from line 512
543512
544513 Must be "grep".
545514
546 - `"grep"`
547
548515 - `enabled: optional boolean or null`
549516
550517 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
from line 520
553520
554521 Permission policy for tool execution.
555522
556 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
523 - `BetaManagedAgentsAlwaysAllowPolicy object`
557524
558525 Tool calls are automatically approved without user confirmation.
559526
560 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
527 - `BetaManagedAgentsAlwaysAskPolicy object`
561528
562529 Tool calls require user confirmation before execution.
563530
564531 - `type: optional "grep"`
565532
566 - `"grep"`
533 - `BetaManagedAgentsWebFetchToolConfigParams object`
567534
568 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
569
570535 Configuration override for the web_fetch tool.
571536
572537 - `name: "web_fetch"`
from line 538
573538
574539 Must be "web_fetch".
575540
576 - `"web_fetch"`
577
578541 - `allowed_domains: optional array of string`
579542
580543 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 554
591554
592555 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
593556
557 format: int32
558
594559 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
595560
596561 Permission policy for tool execution.
597562
598 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
563 - `BetaManagedAgentsAlwaysAllowPolicy object`
599564
600565 Tool calls are automatically approved without user confirmation.
601566
602 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
567 - `BetaManagedAgentsAlwaysAskPolicy object`
603568
604569 Tool calls require user confirmation before execution.
605570
606571 - `type: optional "web_fetch"`
607572
608 - `"web_fetch"`
573 - `BetaManagedAgentsWebSearchToolConfigParams object`
609574
610 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
611
612575 Configuration override for the web_search tool.
613576
614577 - `name: "web_search"`
from line 578
615578
616579 Must be "web_search".
617580
618 - `"web_search"`
619
620581 - `allowed_domains: optional array of string`
621582
622583 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 594
633594
634595 Permission policy for tool execution.
635596
636 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
597 - `BetaManagedAgentsAlwaysAllowPolicy object`
637598
638599 Tool calls are automatically approved without user confirmation.
639600
640 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
601 - `BetaManagedAgentsAlwaysAskPolicy object`
641602
642603 Tool calls require user confirmation before execution.
643604
644605 - `type: optional "web_search"`
645606
646 - `"web_search"`
647
648607 - `user_location: optional BetaManagedAgentsUserLocation or null`
649608
650609 Approximate user location for search result localization.
from line 612
653612
654613 Location precision. Only "approximate" is supported.
655614
656 - `"approximate"`
657
658615 - `city: optional string or null`
659616
660617 City name.
661618
619 minLength: 1, maxLength: 255
620
662621 - `country: optional string or null`
663622
664623 Two-letter ISO 3166-1 country code, uppercase.
from line 626
667626
668627 Region or state name.
669628
629 minLength: 1, maxLength: 255
630
670631 - `timezone: optional string or null`
671632
672633 IANA timezone identifier, e.g. "America/Los_Angeles".
673634
635 minLength: 1, maxLength: 255
636
674637 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
675638
676639 Default configuration for all tools in a toolset.
from line 646
683646
684647 Permission policy for tool execution.
685648
686 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
649 - `BetaManagedAgentsAlwaysAllowPolicy object`
687650
688651 Tool calls are automatically approved without user confirmation.
689652
690 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
653 - `BetaManagedAgentsAlwaysAskPolicy object`
691654
692655 Tool calls require user confirmation before execution.
693656
694 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
657 - `BetaManagedAgentsMCPToolsetParams object`
695658
696659 Configuration for tools from an MCP server defined in `mcp_servers`.
697660
from line 662
699662
700663 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
701664
665 minLength: 1, maxLength: 255
666
702667 - `type: "mcp_toolset"`
703668
704 - `"mcp_toolset"`
705
706669 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
707670
708671 Per-tool configuration overrides.
from line 674
711674
712675 Name of the MCP tool to configure. 1-128 characters.
713676
677 minLength: 1, maxLength: 128
678
714679 - `enabled: optional boolean or null`
715680
716681 Whether this tool is enabled. Overrides the `default_config` setting.
from line 684
719684
720685 Permission policy for tool execution.
721686
722 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
687 - `BetaManagedAgentsAlwaysAllowPolicy object`
723688
724689 Tool calls are automatically approved without user confirmation.
725690
726 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
691 - `BetaManagedAgentsAlwaysAskPolicy object`
727692
728693 Tool calls require user confirmation before execution.
729694
from line 704
739704
740705 Permission policy for tool execution.
741706
742 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
707 - `BetaManagedAgentsAlwaysAllowPolicy object`
743708
744709 Tool calls are automatically approved without user confirmation.
745710
746 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
711 - `BetaManagedAgentsAlwaysAskPolicy object`
747712
748713 Tool calls require user confirmation before execution.
749714
750 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
715 - `BetaManagedAgentsCustomToolParams object`
751716
752717 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.
753718
from line 720
755720
756721 Description of what the tool does, shown to the agent to help it decide when to use the tool.
757722
723 minLength: 1
724
758725 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
759726
760727 JSON Schema for custom tool input parameters.
from line 728
761728
762729 - `type: "object"`
763730
764 - `"object"`
765
766731 - `properties: optional map[unknown] or null`
767732
768733 - `required: optional array of string or null`
from line 736
771736
772737 Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.
773738
739 minLength: 1, maxLength: 128
740
774741 - `type: "custom"`
775742
776 - `"custom"`
777
778743- `version: optional number`
779744
780745 The agent's current version, used to prevent concurrent overwrites. Obtain this value from a create or retrieve response. Must be at least 1 if specified. When supplied, the request fails if it does not match the server's current version; omit to apply the update unconditionally.
781746
782### Returns
747 format: int32
783748
784- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`
749## Returns
785750
751- `BetaManagedAgentsAgent object`
752
786753 A Managed Agents `agent`.
787754
788755 - `id: string`
from line 758
791758
792759 A timestamp in RFC 3339 format
793760
761 format: date-time
762
794763 - `created_at: string`
795764
796765 A timestamp in RFC 3339 format
797766
767 format: date-time
768
798769 - `description: string or null`
799770
800771 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
from line 774
803774
804775 - `type: "url"`
805776
806 - `"url"`
807
808777 - `url: string`
809778
810779 - `metadata: map[string]`
from line 852
883852
884853 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
885854
886 - `BetaManagedAgentsEffortLow object { type }`
855 - `BetaManagedAgentsEffortLow object`
887856
888857 Low effort. Favors latency over reasoning depth.
889858
890859 - `type: "low"`
891860
892 - `"low"`
861 - `BetaManagedAgentsEffortMedium object`
893862
894 - `BetaManagedAgentsEffortMedium object { type }`
895
896863 Medium effort. Balances latency and reasoning depth.
897864
898865 - `type: "medium"`
899866
900 - `"medium"`
867 - `BetaManagedAgentsEffortHigh object`
901868
902 - `BetaManagedAgentsEffortHigh object { type }`
903
904869 High effort. Favors reasoning depth.
905870
906871 - `type: "high"`
907872
908 - `"high"`
873 - `BetaManagedAgentsEffortXhigh object`
909874
910 - `BetaManagedAgentsEffortXhigh object { type }`
911
912875 Extra-high effort. Not all models accept this level.
913876
914877 - `type: "xhigh"`
915878
916 - `"xhigh"`
879 - `BetaManagedAgentsEffortMax object`
917880
918 - `BetaManagedAgentsEffortMax object { type }`
919
920881 Maximum effort. Favors reasoning depth over latency.
921882
922883 - `type: "max"`
923884
924 - `"max"`
925
926885 - `inference_geo: optional string`
927886
928887 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 902
943902
944903 Agents the coordinator may spawn as session threads, each resolved to a specific version.
945904
946 - `BetaManagedAgentsAgentReference object { id, type, version }`
905 - `BetaManagedAgentsAgentReference object`
947906
948907 A resolved agent reference with a concrete version.
949908
from line 910
951910
952911 - `type: "agent"`
953912
954 - `"agent"`
955
956913 - `version: number`
957914
958 - `BetaManagedAgentsAdvisor object { model, type }`
915 format: int32
959916
917 - `BetaManagedAgentsAdvisor object`
918
960919 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
961920
962921 - `model: string`
from line 924
965924
966925 - `type: "advisor"`
967926
968 - `"advisor"`
969
970927 - `type: "coordinator"`
971928
972 - `"coordinator"`
973
974929 - `name: string`
975930
976931 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
977932
978 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
933 - `BetaManagedAgentsAnthropicSkill object`
979934
980935 A resolved Anthropic-managed skill.
981936
from line 938
983938
984939 - `type: "anthropic"`
985940
986 - `"anthropic"`
987
988941 - `version: string`
989942
990 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
943 - `BetaManagedAgentsCustomSkill object`
991944
992945 A resolved user-created custom skill.
993946
from line 948
995948
996949 - `type: "custom"`
997950
998 - `"custom"`
999
1000951 - `version: string`
1001952
1002953 - `system: string or null`
from line 954
1003954
1004955 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
1005956
1006 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
957 - `BetaManagedAgentsAgentToolset20260401 object`
1007958
1008959 - `configs: array of BetaManagedAgentsAgentToolConfig`
1009960
1010 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
961 - `BetaManagedAgentsBashToolConfig object`
1011962
1012963 Configuration for the bash tool.
1013964
from line 966
1015966
1016967 - `name: "bash"`
1017968
1018 - `"bash"`
1019
1020969 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1021970
1022971 Permission policy for tool execution.
1023972
1024 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
973 - `BetaManagedAgentsAlwaysAllowPolicy object`
1025974
1026975 Tool calls are automatically approved without user confirmation.
1027976
1028977 - `type: "always_allow"`
1029978
1030 - `"always_allow"`
979 - `BetaManagedAgentsAlwaysAskPolicy object`
1031980
1032 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1033
1034981 Tool calls require user confirmation before execution.
1035982
1036983 - `type: "always_ask"`
1037984
1038 - `"always_ask"`
1039
1040985 - `type: "bash"`
1041986
1042 - `"bash"`
987 - `BetaManagedAgentsEditToolConfig object`
1043988
1044 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
1045
1046989 Configuration for the edit tool.
1047990
1048991 - `enabled: boolean`
from line 992
1049992
1050993 - `name: "edit"`
1051994
1052 - `"edit"`
1053
1054995 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1055996
1056997 Permission policy for tool execution.
1057998
1058 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
999 - `BetaManagedAgentsAlwaysAllowPolicy object`
10591000
10601001 Tool calls are automatically approved without user confirmation.
10611002
1062 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1003 - `BetaManagedAgentsAlwaysAskPolicy object`
10631004
10641005 Tool calls require user confirmation before execution.
10651006
10661007 - `type: "edit"`
10671008
1068 - `"edit"`
1009 - `BetaManagedAgentsReadToolConfig object`
10691010
1070 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
1071
10721011 Configuration for the read tool.
10731012
10741013 - `enabled: boolean`
from line 1014
10751014
10761015 - `name: "read"`
10771016
1078 - `"read"`
1079
10801017 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
10811018
10821019 Permission policy for tool execution.
10831020
1084 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1021 - `BetaManagedAgentsAlwaysAllowPolicy object`
10851022
10861023 Tool calls are automatically approved without user confirmation.
10871024
1088 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1025 - `BetaManagedAgentsAlwaysAskPolicy object`
10891026
10901027 Tool calls require user confirmation before execution.
10911028
10921029 - `type: "read"`
10931030
1094 - `"read"`
1031 - `BetaManagedAgentsWriteToolConfig object`
10951032
1096 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
1097
10981033 Configuration for the write tool.
10991034
11001035 - `enabled: boolean`
from line 1036
11011036
11021037 - `name: "write"`
11031038
1104 - `"write"`
1105
11061039 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11071040
11081041 Permission policy for tool execution.
11091042
1110 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1043 - `BetaManagedAgentsAlwaysAllowPolicy object`
11111044
11121045 Tool calls are automatically approved without user confirmation.
11131046
1114 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1047 - `BetaManagedAgentsAlwaysAskPolicy object`
11151048
11161049 Tool calls require user confirmation before execution.
11171050
11181051 - `type: "write"`
11191052
1120 - `"write"`
1053 - `BetaManagedAgentsGlobToolConfig object`
11211054
1122 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
1123
11241055 Configuration for the glob tool.
11251056
11261057 - `enabled: boolean`
from line 1058
11271058
11281059 - `name: "glob"`
11291060
1130 - `"glob"`
1131
11321061 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11331062
11341063 Permission policy for tool execution.
11351064
1136 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1065 - `BetaManagedAgentsAlwaysAllowPolicy object`
11371066
11381067 Tool calls are automatically approved without user confirmation.
11391068
1140 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1069 - `BetaManagedAgentsAlwaysAskPolicy object`
11411070
11421071 Tool calls require user confirmation before execution.
11431072
11441073 - `type: "glob"`
11451074
1146 - `"glob"`
1075 - `BetaManagedAgentsGrepToolConfig object`
11471076
1148 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
1149
11501077 Configuration for the grep tool.
11511078
11521079 - `enabled: boolean`
from line 1080
11531080
11541081 - `name: "grep"`
11551082
1156 - `"grep"`
1157
11581083 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11591084
11601085 Permission policy for tool execution.
11611086
1162 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1087 - `BetaManagedAgentsAlwaysAllowPolicy object`
11631088
11641089 Tool calls are automatically approved without user confirmation.
11651090
1166 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1091 - `BetaManagedAgentsAlwaysAskPolicy object`
11671092
11681093 Tool calls require user confirmation before execution.
11691094
11701095 - `type: "grep"`
11711096
1172 - `"grep"`
1097 - `BetaManagedAgentsWebFetchToolConfig object`
11731098
1174 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
1175
11761099 Configuration for the web_fetch tool.
11771100
11781101 - `enabled: boolean`
from line 1102
11791102
11801103 - `name: "web_fetch"`
11811104
1182 - `"web_fetch"`
1183
11841105 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
11851106
11861107 Permission policy for tool execution.
11871108
1188 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1109 - `BetaManagedAgentsAlwaysAllowPolicy object`
11891110
11901111 Tool calls are automatically approved without user confirmation.
11911112
1192 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1113 - `BetaManagedAgentsAlwaysAskPolicy object`
11931114
11941115 Tool calls require user confirmation before execution.
11951116
11961117 - `type: "web_fetch"`
11971118
1198 - `"web_fetch"`
1199
12001119 - `allowed_domains: optional array of string`
12011120
12021121 - `blocked_domains: optional array of string`
from line 1122
12031122
12041123 - `max_content_tokens: optional number or null`
12051124
1206 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
1125 format: int32
12071126
1127 - `BetaManagedAgentsWebSearchToolConfig object`
1128
12081129 Configuration for the web_search tool.
12091130
12101131 - `enabled: boolean`
from line 1132
12111132
12121133 - `name: "web_search"`
12131134
1214 - `"web_search"`
1215
12161135 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
12171136
12181137 Permission policy for tool execution.
12191138
1220 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1139 - `BetaManagedAgentsAlwaysAllowPolicy object`
12211140
12221141 Tool calls are automatically approved without user confirmation.
12231142
1224 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1143 - `BetaManagedAgentsAlwaysAskPolicy object`
12251144
12261145 Tool calls require user confirmation before execution.
12271146
12281147 - `type: "web_search"`
12291148
1230 - `"web_search"`
1231
12321149 - `allowed_domains: optional array of string`
12331150
12341151 - `blocked_domains: optional array of string`
from line 1158
12411158
12421159 Location precision. Only "approximate" is supported.
12431160
1244 - `"approximate"`
1245
12461161 - `city: optional string or null`
12471162
12481163 City name.
12491164
1165 minLength: 1, maxLength: 255
1166
12501167 - `country: optional string or null`
12511168
12521169 Two-letter ISO 3166-1 country code, uppercase.
from line 1172
12551172
12561173 Region or state name.
12571174
1175 minLength: 1, maxLength: 255
1176
12581177 - `timezone: optional string or null`
12591178
12601179 IANA timezone identifier, e.g. "America/Los_Angeles".
12611180
1181 minLength: 1, maxLength: 255
1182
12621183 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
12631184
12641185 Resolved default configuration for agent tools.
from line 1190
12691190
12701191 Permission policy for tool execution.
12711192
1272 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1193 - `BetaManagedAgentsAlwaysAllowPolicy object`
12731194
12741195 Tool calls are automatically approved without user confirmation.
12751196
1276 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1197 - `BetaManagedAgentsAlwaysAskPolicy object`
12771198
12781199 Tool calls require user confirmation before execution.
12791200
12801201 - `type: "agent_toolset_20260401"`
12811202
1282 - `"agent_toolset_20260401"`
1203 - `BetaManagedAgentsMCPToolset object`
12831204
1284 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
1285
12861205 - `configs: array of BetaManagedAgentsMCPToolConfig`
12871206
12881207 - `enabled: boolean`
from line 1212
12931212
12941213 Permission policy for tool execution.
12951214
1296 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1215 - `BetaManagedAgentsAlwaysAllowPolicy object`
12971216
12981217 Tool calls are automatically approved without user confirmation.
12991218
1300 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1219 - `BetaManagedAgentsAlwaysAskPolicy object`
13011220
13021221 Tool calls require user confirmation before execution.
13031222
from line 1230
13111230
13121231 Permission policy for tool execution.
13131232
1314 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1233 - `BetaManagedAgentsAlwaysAllowPolicy object`
13151234
13161235 Tool calls are automatically approved without user confirmation.
13171236
1318 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1237 - `BetaManagedAgentsAlwaysAskPolicy object`
13191238
13201239 Tool calls require user confirmation before execution.
13211240
from line 1242
13231242
13241243 - `type: "mcp_toolset"`
13251244
1326 - `"mcp_toolset"`
1245 - `BetaManagedAgentsCustomTool object`
13271246
1328 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
1329
13301247 A custom tool as returned in API responses.
13311248
13321249 - `description: string`
from line 1254
13371254
13381255 - `type: "object"`
13391256
1340 - `"object"`
1341
13421257 - `properties: optional map[unknown] or null`
13431258
13441259 - `required: optional array of string or null`
from line 1262
13471262
13481263 - `type: "custom"`
13491264
1350 - `"custom"`
1351
13521265 - `type: "agent"`
13531266
1354 - `"agent"`
1355
13561267 - `updated_at: string`
13571268
13581269 A timestamp in RFC 3339 format
13591270
1271 format: date-time
1272
13601273 - `version: number`
13611274
13621275 The agent's current version. Starts at 1 and increments when the agent is modified.
13631276
1364### Example
1277 format: int32
13651278
1366```http
1279## Example
1280
1281```bash
13671282curl https://api.anthropic.com/v1/agents/$AGENT_ID \
13681283 -H 'Content-Type: application/json' \
13691284 -H 'anthropic-version: 2023-06-01' \
from line 1291
13761291 }'
13771292```
13781293
1379#### Response
1294### Response (200)
13801295
13811296```json
13821297{
No line in this hunk matches that.