Versions changedapi/beta/agents/versions
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+68added
Lines−123removed
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
### Path parameters ### Query parameters ### Headers #### Response (200) ### Path Parameters ### Query Parameters ### Header Parameters #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Versions
3url: https://platform.claude.com/docs/en/api/beta/agents/versions
4---
5
61# Versions
72
83## List Agent Versions
94
10**get** `/v1/agents/{agent_id}/versions`
5**GET** `/v1/agents/{agent_id}/versions`
116
127List Agent Versions
138
14### Path Parameters
9### Path parameters
1510
1611- `agent_id: string`
1712
18### Query Parameters
13### Query parameters
1914
2015- `limit: optional number`
2116
2217 Maximum results per page. Default 20, maximum 100.
2318
19 format: int32
20
2421- `page: optional string`
2522
2623 Opaque pagination cursor.
2724
28### Header Parameters
25### Headers
2926
3027- `"anthropic-beta": optional array of AnthropicBeta`
3128
from line 112
115112
116113 A timestamp in RFC 3339 format
117114
115 format: date-time
116
118117 - `created_at: string`
119118
120119 A timestamp in RFC 3339 format
121120
121 format: date-time
122
122123 - `description: string or null`
123124
124125 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
from line 128
127128
128129 - `type: "url"`
129130
130 - `"url"`
131
132131 - `url: string`
133132
134133 - `metadata: map[string]`
from line 206
207206
208207 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
209208
210 - `BetaManagedAgentsEffortLow object { type }`
209 - `BetaManagedAgentsEffortLow object`
211210
212211 Low effort. Favors latency over reasoning depth.
213212
214213 - `type: "low"`
215214
216 - `"low"`
215 - `BetaManagedAgentsEffortMedium object`
217216
218 - `BetaManagedAgentsEffortMedium object { type }`
219
220217 Medium effort. Balances latency and reasoning depth.
221218
222219 - `type: "medium"`
223220
224 - `"medium"`
221 - `BetaManagedAgentsEffortHigh object`
225222
226 - `BetaManagedAgentsEffortHigh object { type }`
227
228223 High effort. Favors reasoning depth.
229224
230225 - `type: "high"`
231226
232 - `"high"`
227 - `BetaManagedAgentsEffortXhigh object`
233228
234 - `BetaManagedAgentsEffortXhigh object { type }`
235
236229 Extra-high effort. Not all models accept this level.
237230
238231 - `type: "xhigh"`
239232
240 - `"xhigh"`
233 - `BetaManagedAgentsEffortMax object`
241234
242 - `BetaManagedAgentsEffortMax object { type }`
243
244235 Maximum effort. Favors reasoning depth over latency.
245236
246237 - `type: "max"`
247238
248 - `"max"`
249
250239 - `inference_geo: optional string`
251240
252241 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 256
267256
268257 Agents the coordinator may spawn as session threads, each resolved to a specific version.
269258
270 - `BetaManagedAgentsAgentReference object { id, type, version }`
259 - `BetaManagedAgentsAgentReference object`
271260
272261 A resolved agent reference with a concrete version.
273262
from line 264
275264
276265 - `type: "agent"`
277266
278 - `"agent"`
279
280267 - `version: number`
281268
282 - `BetaManagedAgentsAdvisor object { model, type }`
269 format: int32
283270
271 - `BetaManagedAgentsAdvisor object`
272
284273 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
285274
286275 - `model: string`
from line 278
289278
290279 - `type: "advisor"`
291280
292 - `"advisor"`
293
294281 - `type: "coordinator"`
295282
296 - `"coordinator"`
297
298283 - `name: string`
299284
300285 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
301286
302 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
287 - `BetaManagedAgentsAnthropicSkill object`
303288
304289 A resolved Anthropic-managed skill.
305290
from line 292
307292
308293 - `type: "anthropic"`
309294
310 - `"anthropic"`
311
312295 - `version: string`
313296
314 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
297 - `BetaManagedAgentsCustomSkill object`
315298
316299 A resolved user-created custom skill.
317300
from line 302
319302
320303 - `type: "custom"`
321304
322 - `"custom"`
323
324305 - `version: string`
325306
326307 - `system: string or null`
from line 308
327308
328309 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
329310
330 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
311 - `BetaManagedAgentsAgentToolset20260401 object`
331312
332313 - `configs: array of BetaManagedAgentsAgentToolConfig`
333314
334 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
315 - `BetaManagedAgentsBashToolConfig object`
335316
336317 Configuration for the bash tool.
337318
from line 320
339320
340321 - `name: "bash"`
341322
342 - `"bash"`
343
344323 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
345324
346325 Permission policy for tool execution.
347326
348 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
327 - `BetaManagedAgentsAlwaysAllowPolicy object`
349328
350329 Tool calls are automatically approved without user confirmation.
351330
352331 - `type: "always_allow"`
353332
354 - `"always_allow"`
333 - `BetaManagedAgentsAlwaysAskPolicy object`
355334
356 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
357
358335 Tool calls require user confirmation before execution.
359336
360337 - `type: "always_ask"`
361338
362 - `"always_ask"`
363
364339 - `type: "bash"`
365340
366 - `"bash"`
341 - `BetaManagedAgentsEditToolConfig object`
367342
368 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
369
370343 Configuration for the edit tool.
371344
372345 - `enabled: boolean`
from line 346
373346
374347 - `name: "edit"`
375348
376 - `"edit"`
377
378349 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
379350
380351 Permission policy for tool execution.
381352
382 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
353 - `BetaManagedAgentsAlwaysAllowPolicy object`
383354
384355 Tool calls are automatically approved without user confirmation.
385356
386 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
357 - `BetaManagedAgentsAlwaysAskPolicy object`
387358
388359 Tool calls require user confirmation before execution.
389360
390361 - `type: "edit"`
391362
392 - `"edit"`
363 - `BetaManagedAgentsReadToolConfig object`
393364
394 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
395
396365 Configuration for the read tool.
397366
398367 - `enabled: boolean`
from line 368
399368
400369 - `name: "read"`
401370
402 - `"read"`
403
404371 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
405372
406373 Permission policy for tool execution.
407374
408 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
375 - `BetaManagedAgentsAlwaysAllowPolicy object`
409376
410377 Tool calls are automatically approved without user confirmation.
411378
412 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
379 - `BetaManagedAgentsAlwaysAskPolicy object`
413380
414381 Tool calls require user confirmation before execution.
415382
416383 - `type: "read"`
417384
418 - `"read"`
385 - `BetaManagedAgentsWriteToolConfig object`
419386
420 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
421
422387 Configuration for the write tool.
423388
424389 - `enabled: boolean`
from line 390
425390
426391 - `name: "write"`
427392
428 - `"write"`
429
430393 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
431394
432395 Permission policy for tool execution.
433396
434 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
397 - `BetaManagedAgentsAlwaysAllowPolicy object`
435398
436399 Tool calls are automatically approved without user confirmation.
437400
438 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
401 - `BetaManagedAgentsAlwaysAskPolicy object`
439402
440403 Tool calls require user confirmation before execution.
441404
442405 - `type: "write"`
443406
444 - `"write"`
407 - `BetaManagedAgentsGlobToolConfig object`
445408
446 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
447
448409 Configuration for the glob tool.
449410
450411 - `enabled: boolean`
from line 412
451412
452413 - `name: "glob"`
453414
454 - `"glob"`
455
456415 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
457416
458417 Permission policy for tool execution.
459418
460 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
419 - `BetaManagedAgentsAlwaysAllowPolicy object`
461420
462421 Tool calls are automatically approved without user confirmation.
463422
464 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
423 - `BetaManagedAgentsAlwaysAskPolicy object`
465424
466425 Tool calls require user confirmation before execution.
467426
468427 - `type: "glob"`
469428
470 - `"glob"`
429 - `BetaManagedAgentsGrepToolConfig object`
471430
472 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
473
474431 Configuration for the grep tool.
475432
476433 - `enabled: boolean`
from line 434
477434
478435 - `name: "grep"`
479436
480 - `"grep"`
481
482437 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
483438
484439 Permission policy for tool execution.
485440
486 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
441 - `BetaManagedAgentsAlwaysAllowPolicy object`
487442
488443 Tool calls are automatically approved without user confirmation.
489444
490 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
445 - `BetaManagedAgentsAlwaysAskPolicy object`
491446
492447 Tool calls require user confirmation before execution.
493448
494449 - `type: "grep"`
495450
496 - `"grep"`
451 - `BetaManagedAgentsWebFetchToolConfig object`
497452
498 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
499
500453 Configuration for the web_fetch tool.
501454
502455 - `enabled: boolean`
from line 456
503456
504457 - `name: "web_fetch"`
505458
506 - `"web_fetch"`
507
508459 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
509460
510461 Permission policy for tool execution.
511462
512 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
463 - `BetaManagedAgentsAlwaysAllowPolicy object`
513464
514465 Tool calls are automatically approved without user confirmation.
515466
516 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
467 - `BetaManagedAgentsAlwaysAskPolicy object`
517468
518469 Tool calls require user confirmation before execution.
519470
520471 - `type: "web_fetch"`
521472
522 - `"web_fetch"`
523
524473 - `allowed_domains: optional array of string`
525474
526475 - `blocked_domains: optional array of string`
from line 476
527476
528477 - `max_content_tokens: optional number or null`
529478
530 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
479 format: int32
531480
481 - `BetaManagedAgentsWebSearchToolConfig object`
482
532483 Configuration for the web_search tool.
533484
534485 - `enabled: boolean`
from line 486
535486
536487 - `name: "web_search"`
537488
538 - `"web_search"`
539
540489 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
541490
542491 Permission policy for tool execution.
543492
544 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
493 - `BetaManagedAgentsAlwaysAllowPolicy object`
545494
546495 Tool calls are automatically approved without user confirmation.
547496
548 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
497 - `BetaManagedAgentsAlwaysAskPolicy object`
549498
550499 Tool calls require user confirmation before execution.
551500
552501 - `type: "web_search"`
553502
554 - `"web_search"`
555
556503 - `allowed_domains: optional array of string`
557504
558505 - `blocked_domains: optional array of string`
from line 512
565512
566513 Location precision. Only "approximate" is supported.
567514
568 - `"approximate"`
569
570515 - `city: optional string or null`
571516
572517 City name.
573518
519 minLength: 1, maxLength: 255
520
574521 - `country: optional string or null`
575522
576523 Two-letter ISO 3166-1 country code, uppercase.
from line 526
579526
580527 Region or state name.
581528
529 minLength: 1, maxLength: 255
530
582531 - `timezone: optional string or null`
583532
584533 IANA timezone identifier, e.g. "America/Los_Angeles".
585534
535 minLength: 1, maxLength: 255
536
586537 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
587538
588539 Resolved default configuration for agent tools.
from line 544
593544
594545 Permission policy for tool execution.
595546
596 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
547 - `BetaManagedAgentsAlwaysAllowPolicy object`
597548
598549 Tool calls are automatically approved without user confirmation.
599550
600 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
551 - `BetaManagedAgentsAlwaysAskPolicy object`
601552
602553 Tool calls require user confirmation before execution.
603554
604555 - `type: "agent_toolset_20260401"`
605556
606 - `"agent_toolset_20260401"`
557 - `BetaManagedAgentsMCPToolset object`
607558
608 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
609
610559 - `configs: array of BetaManagedAgentsMCPToolConfig`
611560
612561 - `enabled: boolean`
from line 566
617566
618567 Permission policy for tool execution.
619568
620 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
569 - `BetaManagedAgentsAlwaysAllowPolicy object`
621570
622571 Tool calls are automatically approved without user confirmation.
623572
624 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
573 - `BetaManagedAgentsAlwaysAskPolicy object`
625574
626575 Tool calls require user confirmation before execution.
627576
from line 584
635584
636585 Permission policy for tool execution.
637586
638 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
587 - `BetaManagedAgentsAlwaysAllowPolicy object`
639588
640589 Tool calls are automatically approved without user confirmation.
641590
642 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
591 - `BetaManagedAgentsAlwaysAskPolicy object`
643592
644593 Tool calls require user confirmation before execution.
645594
from line 596
647596
648597 - `type: "mcp_toolset"`
649598
650 - `"mcp_toolset"`
599 - `BetaManagedAgentsCustomTool object`
651600
652 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
653
654601 A custom tool as returned in API responses.
655602
656603 - `description: string`
from line 608
661608
662609 - `type: "object"`
663610
664 - `"object"`
665
666611 - `properties: optional map[unknown] or null`
667612
668613 - `required: optional array of string or null`
from line 616
671616
672617 - `type: "custom"`
673618
674 - `"custom"`
675
676619 - `type: "agent"`
677620
678 - `"agent"`
679
680621 - `updated_at: string`
681622
682623 A timestamp in RFC 3339 format
683624
625 format: date-time
626
684627 - `version: number`
685628
686629 The agent's current version. Starts at 1 and increments when the agent is modified.
687630
631 format: int32
632
688633- `next_page: optional string or null`
689634
690635 Opaque cursor for the next page. Null when no more results.
from line 636
691636
692637### Example
693638
694```http
639```bash
695640curl https://api.anthropic.com/v1/agents/$AGENT_ID/versions \
696641 -H 'anthropic-version: 2023-06-01' \
697642 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 643
698643 -H "X-Api-Key: $ANTHROPIC_API_KEY"
699644```
700645
701#### Response
646#### Response (200)
702647
703648```json
704649{
No line in this hunk matches that.