The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: List Agents
3url: https://platform.claude.com/docs/en/api/beta/agents/list
4---
5
16# List Agents
27
38**GET** `/v1/agents`
from line 45
4045
4146 - `string`
4247
43 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
48 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
4449
4550 - `"message-batches-2024-09-24"`
4651
from line 93
8893
8994 - `"user-profiles-2026-08-18"`
9095
96 - `"user-profiles-2026-09-04"`
97
9198 - `"advisor-tool-2026-03-01"`
9299
93100 - `"managed-agents-2026-04-01"`
from line 137
130137
131138 - `"mid-conversation-system-clear-at-2026-08-21"`
132139
140- `"anthropic-workspace-id": optional string`
141
133142## Returns
134143
135144- `data: array of BetaManagedAgentsAgent`
from line 145
136145
137146 List of agents.
138147
148 - `type: "agent"`
149
139150 - `id: string`
140151
141152 - `archived_at: string or null`
from line 165
154165
155166 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
156167
157 - `name: string`
158
159168 - `type: "url"`
160169
170 - `name: string`
171
161172 - `url: string`
162173
163174 - `metadata: map[string]`
from line 297
286297
287298 Resolved coordinator topology with a concrete agent roster.
288299
300 - `type: "coordinator"`
301
289302 - `agents: array of BetaManagedAgentsAgentReference or BetaManagedAgentsAdvisor`
290303
291304 Agents the coordinator may spawn as session threads, each resolved to a specific version.
from line 307
294307
295308 A resolved agent reference with a concrete version.
296309
297 - `id: string`
298
299310 - `type: "agent"`
300311
312 - `id: string`
313
301314 - `version: number`
302315
303316 format: int32
from line 319
306319
307320 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
308321
322 - `type: "advisor"`
323
309324 - `model: string`
310325
311326 The advisor model id.
312327
313 - `type: "advisor"`
314
315 - `type: "coordinator"`
316
317328 - `name: string`
318329
319330 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
from line 333
322333
323334 A resolved Anthropic-managed skill.
324335
325 - `skill_id: string`
326
327336 - `type: "anthropic"`
328337
338 - `skill_id: string`
339
329340 - `version: string`
330341
331342 - `BetaManagedAgentsCustomSkill object`
from line 343
332343
333344 A resolved user-created custom skill.
334345
335 - `skill_id: string`
336
337346 - `type: "custom"`
338347
348 - `skill_id: string`
349
339350 - `version: string`
340351
341352 - `system: string or null`
from line 355
344355
345356 - `BetaManagedAgentsAgentToolset20260401 object`
346357
358 - `type: "agent_toolset_20260401"`
359
347360 - `configs: array of BetaManagedAgentsAgentToolConfig`
348361
349362 - `BetaManagedAgentsBashToolConfig object`
from line 363
350363
351364 Configuration for the bash tool.
352365
366 - `type: "bash"`
367
353368 - `enabled: boolean`
354369
355370 - `name: "bash"`
356371
357 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
372 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
358373
359374 Permission policy for tool execution.
360375
from line 385
370385
371386 - `type: "always_ask"`
372387
373 - `type: "bash"`
388 - `BetaManagedAgentsAutoPolicy object`
374389
390 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.
391
392 - `type: "auto"`
393
375394 - `BetaManagedAgentsEditToolConfig object`
376395
377396 Configuration for the edit tool.
378397
398 - `type: "edit"`
399
379400 - `enabled: boolean`
380401
381402 - `name: "edit"`
382403
383 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
404 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
384405
385406 Permission policy for tool execution.
386407
from line 413
392413
393414 Tool calls require user confirmation before execution.
394415
395 - `type: "edit"`
416 - `BetaManagedAgentsAutoPolicy object`
396417
418 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.
419
397420 - `BetaManagedAgentsReadToolConfig object`
398421
399422 Configuration for the read tool.
400423
424 - `type: "read"`
425
401426 - `enabled: boolean`
402427
403428 - `name: "read"`
404429
405 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
430 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
406431
407432 Permission policy for tool execution.
408433
from line 439
414439
415440 Tool calls require user confirmation before execution.
416441
417 - `type: "read"`
442 - `BetaManagedAgentsAutoPolicy object`
418443
444 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.
445
419446 - `BetaManagedAgentsWriteToolConfig object`
420447
421448 Configuration for the write tool.
422449
450 - `type: "write"`
451
423452 - `enabled: boolean`
424453
425454 - `name: "write"`
426455
427 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
456 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
428457
429458 Permission policy for tool execution.
430459
from line 465
436465
437466 Tool calls require user confirmation before execution.
438467
439 - `type: "write"`
468 - `BetaManagedAgentsAutoPolicy object`
440469
470 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.
471
441472 - `BetaManagedAgentsGlobToolConfig object`
442473
443474 Configuration for the glob tool.
444475
476 - `type: "glob"`
477
445478 - `enabled: boolean`
446479
447480 - `name: "glob"`
448481
449 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
482 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
450483
451484 Permission policy for tool execution.
452485
from line 491
458491
459492 Tool calls require user confirmation before execution.
460493
461 - `type: "glob"`
494 - `BetaManagedAgentsAutoPolicy object`
462495
496 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.
497
463498 - `BetaManagedAgentsGrepToolConfig object`
464499
465500 Configuration for the grep tool.
466501
502 - `type: "grep"`
503
467504 - `enabled: boolean`
468505
469506 - `name: "grep"`
470507
471 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
508 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
472509
473510 Permission policy for tool execution.
474511
from line 517
480517
481518 Tool calls require user confirmation before execution.
482519
483 - `type: "grep"`
520 - `BetaManagedAgentsAutoPolicy object`
484521
522 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.
523
485524 - `BetaManagedAgentsWebFetchToolConfig object`
486525
487526 Configuration for the web_fetch tool.
488527
528 - `type: "web_fetch"`
529
489530 - `enabled: boolean`
490531
491532 - `name: "web_fetch"`
492533
493 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
534 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
494535
495536 Permission policy for tool execution.
496537
from line 543
502543
503544 Tool calls require user confirmation before execution.
504545
505 - `type: "web_fetch"`
546 - `BetaManagedAgentsAutoPolicy object`
506547
548 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.
549
507550 - `allowed_domains: optional array of string`
508551
509552 - `blocked_domains: optional array of string`
from line 559
516559
517560 Configuration for the web_search tool.
518561
562 - `type: "web_search"`
563
519564 - `enabled: boolean`
520565
521566 - `name: "web_search"`
522567
523 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
568 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
524569
525570 Permission policy for tool execution.
526571
from line 577
532577
533578 Tool calls require user confirmation before execution.
534579
535 - `type: "web_search"`
580 - `BetaManagedAgentsAutoPolicy object`
536581
582 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.
583
537584 - `allowed_domains: optional array of string`
538585
539586 - `blocked_domains: optional array of string`
from line 621
574621
575622 - `enabled: boolean`
576623
577 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
624 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
578625
579626 Permission policy for tool execution.
580627
from line 633
586633
587634 Tool calls require user confirmation before execution.
588635
589 - `type: "agent_toolset_20260401"`
636 - `BetaManagedAgentsAutoPolicy object`
590637
638 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.
639
591640 - `BetaManagedAgentsMCPToolset object`
592641
642 - `type: "mcp_toolset"`
643
593644 - `configs: array of BetaManagedAgentsMCPToolConfig`
594645
595646 - `enabled: boolean`
from line 647
596647
597648 - `name: string`
598649
599 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
650 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
600651
601652 Permission policy for tool execution.
602653
from line 659
608659
609660 Tool calls require user confirmation before execution.
610661
662 - `BetaManagedAgentsAutoPolicy object`
663
664 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.
665
611666 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
612667
613668 Resolved default configuration for all tools from an MCP server.
from line 669
614669
615670 - `enabled: boolean`
616671
617 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
672 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
618673
619674 Permission policy for tool execution.
620675
from line 681
626681
627682 Tool calls require user confirmation before execution.
628683
629 - `mcp_server_name: string`
684 - `BetaManagedAgentsAutoPolicy object`
630685
631 - `type: "mcp_toolset"`
686 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.
632687
688 - `mcp_server_name: string`
689
633690 - `BetaManagedAgentsCustomTool object`
634691
635692 A custom tool as returned in API responses.
636693
694 - `type: "custom"`
695
637696 - `description: string`
638697
639698 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
from line 706
647706 - `required: optional array of string or null`
648707
649708 - `name: string`
650
651 - `type: "custom"`
652
653 - `type: "agent"`
654709
655710 - `updated_at: string`
656711