List Agents changedapi/beta/agents/list
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+76added
Lines−127removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits23to this page, all time
# List Agents ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Agents ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Agents
3url: https://platform.claude.com/docs/en/api/beta/agents/list
4---
1# List Agents
52
6## List Agents
3**GET** `/v1/agents`
74
8**get** `/v1/agents`
9
105List Agents
116
12### Query Parameters
7## Query parameters
138
149- `"created_at[gte]": optional string`
1510
1611 Return agents created at or after this time (inclusive).
1712
13 format: date-time
14
1815- `"created_at[lte]": optional string`
1916
2017 Return agents created at or before this time (inclusive).
2118
19 format: date-time
20
2221- `include_archived: optional boolean`
2322
2423 Include archived agents in results. Defaults to false.
from line 26
2726
2827 Maximum results per page. Default 20, maximum 100.
2928
29 format: int32
30
3031- `page: optional string`
3132
3233 Opaque pagination cursor from a previous response.
3334
34### Header Parameters
35## Headers
3536
3637- `"anthropic-beta": optional array of AnthropicBeta`
3738
from line 110
109110
110111 - `"mid-conversation-tool-changes-2026-07-01"`
111112
112### Returns
113## Returns
113114
114115- `data: array of BetaManagedAgentsAgent`
115116
from line 122
121122
122123 A timestamp in RFC 3339 format
123124
125 format: date-time
126
124127 - `created_at: string`
125128
126129 A timestamp in RFC 3339 format
127130
131 format: date-time
132
128133 - `description: string or null`
129134
130135 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
from line 138
133138
134139 - `type: "url"`
135140
136 - `"url"`
137
138141 - `url: string`
139142
140143 - `metadata: map[string]`
from line 216
213216
214217 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
215218
216 - `BetaManagedAgentsEffortLow object { type }`
219 - `BetaManagedAgentsEffortLow object`
217220
218221 Low effort. Favors latency over reasoning depth.
219222
220223 - `type: "low"`
221224
222 - `"low"`
225 - `BetaManagedAgentsEffortMedium object`
223226
224 - `BetaManagedAgentsEffortMedium object { type }`
225
226227 Medium effort. Balances latency and reasoning depth.
227228
228229 - `type: "medium"`
229230
230 - `"medium"`
231 - `BetaManagedAgentsEffortHigh object`
231232
232 - `BetaManagedAgentsEffortHigh object { type }`
233
234233 High effort. Favors reasoning depth.
235234
236235 - `type: "high"`
237236
238 - `"high"`
237 - `BetaManagedAgentsEffortXhigh object`
239238
240 - `BetaManagedAgentsEffortXhigh object { type }`
241
242239 Extra-high effort. Not all models accept this level.
243240
244241 - `type: "xhigh"`
245242
246 - `"xhigh"`
243 - `BetaManagedAgentsEffortMax object`
247244
248 - `BetaManagedAgentsEffortMax object { type }`
249
250245 Maximum effort. Favors reasoning depth over latency.
251246
252247 - `type: "max"`
253248
254 - `"max"`
255
256249 - `inference_geo: optional string`
257250
258251 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 266
273266
274267 Agents the coordinator may spawn as session threads, each resolved to a specific version.
275268
276 - `BetaManagedAgentsAgentReference object { id, type, version }`
269 - `BetaManagedAgentsAgentReference object`
277270
278271 A resolved agent reference with a concrete version.
279272
from line 274
281274
282275 - `type: "agent"`
283276
284 - `"agent"`
285
286277 - `version: number`
287278
288 - `BetaManagedAgentsAdvisor object { model, type }`
279 format: int32
289280
281 - `BetaManagedAgentsAdvisor object`
282
290283 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
291284
292285 - `model: string`
from line 288
295288
296289 - `type: "advisor"`
297290
298 - `"advisor"`
299
300291 - `type: "coordinator"`
301292
302 - `"coordinator"`
303
304293 - `name: string`
305294
306295 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
307296
308 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
297 - `BetaManagedAgentsAnthropicSkill object`
309298
310299 A resolved Anthropic-managed skill.
311300
from line 302
313302
314303 - `type: "anthropic"`
315304
316 - `"anthropic"`
317
318305 - `version: string`
319306
320 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
307 - `BetaManagedAgentsCustomSkill object`
321308
322309 A resolved user-created custom skill.
323310
from line 312
325312
326313 - `type: "custom"`
327314
328 - `"custom"`
329
330315 - `version: string`
331316
332317 - `system: string or null`
from line 318
333318
334319 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
335320
336 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
321 - `BetaManagedAgentsAgentToolset20260401 object`
337322
338323 - `configs: array of BetaManagedAgentsAgentToolConfig`
339324
340 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
325 - `BetaManagedAgentsBashToolConfig object`
341326
342327 Configuration for the bash tool.
343328
from line 330
345330
346331 - `name: "bash"`
347332
348 - `"bash"`
349
350333 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
351334
352335 Permission policy for tool execution.
353336
354 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
337 - `BetaManagedAgentsAlwaysAllowPolicy object`
355338
356339 Tool calls are automatically approved without user confirmation.
357340
358341 - `type: "always_allow"`
359342
360 - `"always_allow"`
343 - `BetaManagedAgentsAlwaysAskPolicy object`
361344
362 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
363
364345 Tool calls require user confirmation before execution.
365346
366347 - `type: "always_ask"`
367348
368 - `"always_ask"`
369
370349 - `type: "bash"`
371350
372 - `"bash"`
351 - `BetaManagedAgentsEditToolConfig object`
373352
374 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
375
376353 Configuration for the edit tool.
377354
378355 - `enabled: boolean`
from line 356
379356
380357 - `name: "edit"`
381358
382 - `"edit"`
383
384359 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
385360
386361 Permission policy for tool execution.
387362
388 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
363 - `BetaManagedAgentsAlwaysAllowPolicy object`
389364
390365 Tool calls are automatically approved without user confirmation.
391366
392 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
367 - `BetaManagedAgentsAlwaysAskPolicy object`
393368
394369 Tool calls require user confirmation before execution.
395370
396371 - `type: "edit"`
397372
398 - `"edit"`
373 - `BetaManagedAgentsReadToolConfig object`
399374
400 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
401
402375 Configuration for the read tool.
403376
404377 - `enabled: boolean`
from line 378
405378
406379 - `name: "read"`
407380
408 - `"read"`
409
410381 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
411382
412383 Permission policy for tool execution.
413384
414 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
385 - `BetaManagedAgentsAlwaysAllowPolicy object`
415386
416387 Tool calls are automatically approved without user confirmation.
417388
418 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
389 - `BetaManagedAgentsAlwaysAskPolicy object`
419390
420391 Tool calls require user confirmation before execution.
421392
422393 - `type: "read"`
423394
424 - `"read"`
395 - `BetaManagedAgentsWriteToolConfig object`
425396
426 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
427
428397 Configuration for the write tool.
429398
430399 - `enabled: boolean`
from line 400
431400
432401 - `name: "write"`
433402
434 - `"write"`
435
436403 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
437404
438405 Permission policy for tool execution.
439406
440 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
407 - `BetaManagedAgentsAlwaysAllowPolicy object`
441408
442409 Tool calls are automatically approved without user confirmation.
443410
444 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
411 - `BetaManagedAgentsAlwaysAskPolicy object`
445412
446413 Tool calls require user confirmation before execution.
447414
448415 - `type: "write"`
449416
450 - `"write"`
417 - `BetaManagedAgentsGlobToolConfig object`
451418
452 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
453
454419 Configuration for the glob tool.
455420
456421 - `enabled: boolean`
from line 422
457422
458423 - `name: "glob"`
459424
460 - `"glob"`
461
462425 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
463426
464427 Permission policy for tool execution.
465428
466 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
429 - `BetaManagedAgentsAlwaysAllowPolicy object`
467430
468431 Tool calls are automatically approved without user confirmation.
469432
470 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
433 - `BetaManagedAgentsAlwaysAskPolicy object`
471434
472435 Tool calls require user confirmation before execution.
473436
474437 - `type: "glob"`
475438
476 - `"glob"`
439 - `BetaManagedAgentsGrepToolConfig object`
477440
478 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
479
480441 Configuration for the grep tool.
481442
482443 - `enabled: boolean`
from line 444
483444
484445 - `name: "grep"`
485446
486 - `"grep"`
487
488447 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
489448
490449 Permission policy for tool execution.
491450
492 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
451 - `BetaManagedAgentsAlwaysAllowPolicy object`
493452
494453 Tool calls are automatically approved without user confirmation.
495454
496 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
455 - `BetaManagedAgentsAlwaysAskPolicy object`
497456
498457 Tool calls require user confirmation before execution.
499458
500459 - `type: "grep"`
501460
502 - `"grep"`
461 - `BetaManagedAgentsWebFetchToolConfig object`
503462
504 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
505
506463 Configuration for the web_fetch tool.
507464
508465 - `enabled: boolean`
from line 466
509466
510467 - `name: "web_fetch"`
511468
512 - `"web_fetch"`
513
514469 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
515470
516471 Permission policy for tool execution.
517472
518 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
473 - `BetaManagedAgentsAlwaysAllowPolicy object`
519474
520475 Tool calls are automatically approved without user confirmation.
521476
522 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
477 - `BetaManagedAgentsAlwaysAskPolicy object`
523478
524479 Tool calls require user confirmation before execution.
525480
526481 - `type: "web_fetch"`
527482
528 - `"web_fetch"`
529
530483 - `allowed_domains: optional array of string`
531484
532485 - `blocked_domains: optional array of string`
from line 486
533486
534487 - `max_content_tokens: optional number or null`
535488
536 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
489 format: int32
537490
491 - `BetaManagedAgentsWebSearchToolConfig object`
492
538493 Configuration for the web_search tool.
539494
540495 - `enabled: boolean`
from line 496
541496
542497 - `name: "web_search"`
543498
544 - `"web_search"`
545
546499 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
547500
548501 Permission policy for tool execution.
549502
550 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
503 - `BetaManagedAgentsAlwaysAllowPolicy object`
551504
552505 Tool calls are automatically approved without user confirmation.
553506
554 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
507 - `BetaManagedAgentsAlwaysAskPolicy object`
555508
556509 Tool calls require user confirmation before execution.
557510
558511 - `type: "web_search"`
559512
560 - `"web_search"`
561
562513 - `allowed_domains: optional array of string`
563514
564515 - `blocked_domains: optional array of string`
from line 522
571522
572523 Location precision. Only "approximate" is supported.
573524
574 - `"approximate"`
575
576525 - `city: optional string or null`
577526
578527 City name.
579528
529 minLength: 1, maxLength: 255
530
580531 - `country: optional string or null`
581532
582533 Two-letter ISO 3166-1 country code, uppercase.
from line 536
585536
586537 Region or state name.
587538
539 minLength: 1, maxLength: 255
540
588541 - `timezone: optional string or null`
589542
590543 IANA timezone identifier, e.g. "America/Los_Angeles".
591544
545 minLength: 1, maxLength: 255
546
592547 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
593548
594549 Resolved default configuration for agent tools.
from line 554
599554
600555 Permission policy for tool execution.
601556
602 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
557 - `BetaManagedAgentsAlwaysAllowPolicy object`
603558
604559 Tool calls are automatically approved without user confirmation.
605560
606 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
561 - `BetaManagedAgentsAlwaysAskPolicy object`
607562
608563 Tool calls require user confirmation before execution.
609564
610565 - `type: "agent_toolset_20260401"`
611566
612 - `"agent_toolset_20260401"`
567 - `BetaManagedAgentsMCPToolset object`
613568
614 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
615
616569 - `configs: array of BetaManagedAgentsMCPToolConfig`
617570
618571 - `enabled: boolean`
from line 576
623576
624577 Permission policy for tool execution.
625578
626 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
579 - `BetaManagedAgentsAlwaysAllowPolicy object`
627580
628581 Tool calls are automatically approved without user confirmation.
629582
630 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
583 - `BetaManagedAgentsAlwaysAskPolicy object`
631584
632585 Tool calls require user confirmation before execution.
633586
from line 594
641594
642595 Permission policy for tool execution.
643596
644 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
597 - `BetaManagedAgentsAlwaysAllowPolicy object`
645598
646599 Tool calls are automatically approved without user confirmation.
647600
648 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
601 - `BetaManagedAgentsAlwaysAskPolicy object`
649602
650603 Tool calls require user confirmation before execution.
651604
from line 606
653606
654607 - `type: "mcp_toolset"`
655608
656 - `"mcp_toolset"`
609 - `BetaManagedAgentsCustomTool object`
657610
658 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
659
660611 A custom tool as returned in API responses.
661612
662613 - `description: string`
from line 618
667618
668619 - `type: "object"`
669620
670 - `"object"`
671
672621 - `properties: optional map[unknown] or null`
673622
674623 - `required: optional array of string or null`
from line 626
677626
678627 - `type: "custom"`
679628
680 - `"custom"`
681
682629 - `type: "agent"`
683630
684 - `"agent"`
685
686631 - `updated_at: string`
687632
688633 A timestamp in RFC 3339 format
689634
635 format: date-time
636
690637 - `version: number`
691638
692639 The agent's current version. Starts at 1 and increments when the agent is modified.
693640
641 format: int32
642
694643- `next_page: optional string or null`
695644
696645 Opaque cursor for the next page. Null when no more results.
697646
698### Example
647## Example
699648
700```http
649```bash
701650curl https://api.anthropic.com/v1/agents \
702651 -H 'anthropic-version: 2023-06-01' \
703652 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 653
704653 -H "X-Api-Key: $ANTHROPIC_API_KEY"
705654```
706655
707#### Response
656### Response (200)
708657
709658```json
710659{
No line in this hunk matches that.