Get Agent changedapi/beta/agents/retrieve
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+75added
Lines−130removed
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
# Get Agent ## Path parameters ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## Get Agent ### Path Parameters ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Get Agent
3url: https://platform.claude.com/docs/en/api/beta/agents/retrieve
4---
1# Get Agent
52
6## Get Agent
3**GET** `/v1/agents/{agent_id}`
74
8**get** `/v1/agents/{agent_id}`
9
105Get Agent
116
12### Path Parameters
7## Path parameters
138
149- `agent_id: string`
1510
16### Query Parameters
11## Query parameters
1712
1813- `version: optional number`
1914
2015 Agent version. Omit for the most recent version. Must be at least 1 if specified.
2116
22### Header Parameters
17 format: int32
2318
19## Headers
20
2421- `"anthropic-beta": optional array of AnthropicBeta`
2522
2623 Optional header to specify the beta version(s) you want to use.
from line 94
9794
9895 - `"mid-conversation-tool-changes-2026-07-01"`
9996
100### Returns
97## Returns
10198
102- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`
99- `BetaManagedAgentsAgent object`
103100
104101 A Managed Agents `agent`.
105102
from line 106
109106
110107 A timestamp in RFC 3339 format
111108
109 format: date-time
110
112111 - `created_at: string`
113112
114113 A timestamp in RFC 3339 format
115114
115 format: date-time
116
116117 - `description: string or null`
117118
118119 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
from line 122
121122
122123 - `type: "url"`
123124
124 - `"url"`
125
126125 - `url: string`
127126
128127 - `metadata: map[string]`
from line 200
201200
202201 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.
203202
204 - `BetaManagedAgentsEffortLow object { type }`
203 - `BetaManagedAgentsEffortLow object`
205204
206205 Low effort. Favors latency over reasoning depth.
207206
208207 - `type: "low"`
209208
210 - `"low"`
209 - `BetaManagedAgentsEffortMedium object`
211210
212 - `BetaManagedAgentsEffortMedium object { type }`
213
214211 Medium effort. Balances latency and reasoning depth.
215212
216213 - `type: "medium"`
217214
218 - `"medium"`
215 - `BetaManagedAgentsEffortHigh object`
219216
220 - `BetaManagedAgentsEffortHigh object { type }`
221
222217 High effort. Favors reasoning depth.
223218
224219 - `type: "high"`
225220
226 - `"high"`
221 - `BetaManagedAgentsEffortXhigh object`
227222
228 - `BetaManagedAgentsEffortXhigh object { type }`
229
230223 Extra-high effort. Not all models accept this level.
231224
232225 - `type: "xhigh"`
233226
234 - `"xhigh"`
227 - `BetaManagedAgentsEffortMax object`
235228
236 - `BetaManagedAgentsEffortMax object { type }`
237
238229 Maximum effort. Favors reasoning depth over latency.
239230
240231 - `type: "max"`
241232
242 - `"max"`
243
244233 - `inference_geo: optional string`
245234
246235 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
from line 250
261250
262251 Agents the coordinator may spawn as session threads, each resolved to a specific version.
263252
264 - `BetaManagedAgentsAgentReference object { id, type, version }`
253 - `BetaManagedAgentsAgentReference object`
265254
266255 A resolved agent reference with a concrete version.
267256
from line 258
269258
270259 - `type: "agent"`
271260
272 - `"agent"`
273
274261 - `version: number`
275262
276 - `BetaManagedAgentsAdvisor object { model, type }`
263 format: int32
277264
265 - `BetaManagedAgentsAdvisor object`
266
278267 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
279268
280269 - `model: string`
from line 272
283272
284273 - `type: "advisor"`
285274
286 - `"advisor"`
287
288275 - `type: "coordinator"`
289276
290 - `"coordinator"`
291
292277 - `name: string`
293278
294279 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
295280
296 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`
281 - `BetaManagedAgentsAnthropicSkill object`
297282
298283 A resolved Anthropic-managed skill.
299284
from line 286
301286
302287 - `type: "anthropic"`
303288
304 - `"anthropic"`
305
306289 - `version: string`
307290
308 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
291 - `BetaManagedAgentsCustomSkill object`
309292
310293 A resolved user-created custom skill.
311294
from line 296
313296
314297 - `type: "custom"`
315298
316 - `"custom"`
317
318299 - `version: string`
319300
320301 - `system: string or null`
from line 302
321302
322303 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
323304
324 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
305 - `BetaManagedAgentsAgentToolset20260401 object`
325306
326307 - `configs: array of BetaManagedAgentsAgentToolConfig`
327308
328 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
309 - `BetaManagedAgentsBashToolConfig object`
329310
330311 Configuration for the bash tool.
331312
from line 314
333314
334315 - `name: "bash"`
335316
336 - `"bash"`
337
338317 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
339318
340319 Permission policy for tool execution.
341320
342 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
321 - `BetaManagedAgentsAlwaysAllowPolicy object`
343322
344323 Tool calls are automatically approved without user confirmation.
345324
346325 - `type: "always_allow"`
347326
348 - `"always_allow"`
327 - `BetaManagedAgentsAlwaysAskPolicy object`
349328
350 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
351
352329 Tool calls require user confirmation before execution.
353330
354331 - `type: "always_ask"`
355332
356 - `"always_ask"`
357
358333 - `type: "bash"`
359334
360 - `"bash"`
335 - `BetaManagedAgentsEditToolConfig object`
361336
362 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
363
364337 Configuration for the edit tool.
365338
366339 - `enabled: boolean`
from line 340
367340
368341 - `name: "edit"`
369342
370 - `"edit"`
371
372343 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
373344
374345 Permission policy for tool execution.
375346
376 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
347 - `BetaManagedAgentsAlwaysAllowPolicy object`
377348
378349 Tool calls are automatically approved without user confirmation.
379350
380 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
351 - `BetaManagedAgentsAlwaysAskPolicy object`
381352
382353 Tool calls require user confirmation before execution.
383354
384355 - `type: "edit"`
385356
386 - `"edit"`
357 - `BetaManagedAgentsReadToolConfig object`
387358
388 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
389
390359 Configuration for the read tool.
391360
392361 - `enabled: boolean`
from line 362
393362
394363 - `name: "read"`
395364
396 - `"read"`
397
398365 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
399366
400367 Permission policy for tool execution.
401368
402 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
369 - `BetaManagedAgentsAlwaysAllowPolicy object`
403370
404371 Tool calls are automatically approved without user confirmation.
405372
406 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
373 - `BetaManagedAgentsAlwaysAskPolicy object`
407374
408375 Tool calls require user confirmation before execution.
409376
410377 - `type: "read"`
411378
412 - `"read"`
379 - `BetaManagedAgentsWriteToolConfig object`
413380
414 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
415
416381 Configuration for the write tool.
417382
418383 - `enabled: boolean`
from line 384
419384
420385 - `name: "write"`
421386
422 - `"write"`
423
424387 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
425388
426389 Permission policy for tool execution.
427390
428 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
391 - `BetaManagedAgentsAlwaysAllowPolicy object`
429392
430393 Tool calls are automatically approved without user confirmation.
431394
432 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
395 - `BetaManagedAgentsAlwaysAskPolicy object`
433396
434397 Tool calls require user confirmation before execution.
435398
436399 - `type: "write"`
437400
438 - `"write"`
401 - `BetaManagedAgentsGlobToolConfig object`
439402
440 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
441
442403 Configuration for the glob tool.
443404
444405 - `enabled: boolean`
from line 406
445406
446407 - `name: "glob"`
447408
448 - `"glob"`
449
450409 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
451410
452411 Permission policy for tool execution.
453412
454 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
413 - `BetaManagedAgentsAlwaysAllowPolicy object`
455414
456415 Tool calls are automatically approved without user confirmation.
457416
458 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
417 - `BetaManagedAgentsAlwaysAskPolicy object`
459418
460419 Tool calls require user confirmation before execution.
461420
462421 - `type: "glob"`
463422
464 - `"glob"`
423 - `BetaManagedAgentsGrepToolConfig object`
465424
466 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
467
468425 Configuration for the grep tool.
469426
470427 - `enabled: boolean`
from line 428
471428
472429 - `name: "grep"`
473430
474 - `"grep"`
475
476431 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
477432
478433 Permission policy for tool execution.
479434
480 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
435 - `BetaManagedAgentsAlwaysAllowPolicy object`
481436
482437 Tool calls are automatically approved without user confirmation.
483438
484 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
439 - `BetaManagedAgentsAlwaysAskPolicy object`
485440
486441 Tool calls require user confirmation before execution.
487442
488443 - `type: "grep"`
489444
490 - `"grep"`
445 - `BetaManagedAgentsWebFetchToolConfig object`
491446
492 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
493
494447 Configuration for the web_fetch tool.
495448
496449 - `enabled: boolean`
from line 450
497450
498451 - `name: "web_fetch"`
499452
500 - `"web_fetch"`
501
502453 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
503454
504455 Permission policy for tool execution.
505456
506 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
457 - `BetaManagedAgentsAlwaysAllowPolicy object`
507458
508459 Tool calls are automatically approved without user confirmation.
509460
510 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
461 - `BetaManagedAgentsAlwaysAskPolicy object`
511462
512463 Tool calls require user confirmation before execution.
513464
514465 - `type: "web_fetch"`
515466
516 - `"web_fetch"`
517
518467 - `allowed_domains: optional array of string`
519468
520469 - `blocked_domains: optional array of string`
from line 470
521470
522471 - `max_content_tokens: optional number or null`
523472
524 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
473 format: int32
525474
475 - `BetaManagedAgentsWebSearchToolConfig object`
476
526477 Configuration for the web_search tool.
527478
528479 - `enabled: boolean`
from line 480
529480
530481 - `name: "web_search"`
531482
532 - `"web_search"`
533
534483 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
535484
536485 Permission policy for tool execution.
537486
538 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
487 - `BetaManagedAgentsAlwaysAllowPolicy object`
539488
540489 Tool calls are automatically approved without user confirmation.
541490
542 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
491 - `BetaManagedAgentsAlwaysAskPolicy object`
543492
544493 Tool calls require user confirmation before execution.
545494
546495 - `type: "web_search"`
547496
548 - `"web_search"`
549
550497 - `allowed_domains: optional array of string`
551498
552499 - `blocked_domains: optional array of string`
from line 506
559506
560507 Location precision. Only "approximate" is supported.
561508
562 - `"approximate"`
563
564509 - `city: optional string or null`
565510
566511 City name.
567512
513 minLength: 1, maxLength: 255
514
568515 - `country: optional string or null`
569516
570517 Two-letter ISO 3166-1 country code, uppercase.
from line 520
573520
574521 Region or state name.
575522
523 minLength: 1, maxLength: 255
524
576525 - `timezone: optional string or null`
577526
578527 IANA timezone identifier, e.g. "America/Los_Angeles".
579528
529 minLength: 1, maxLength: 255
530
580531 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
581532
582533 Resolved default configuration for agent tools.
from line 538
587538
588539 Permission policy for tool execution.
589540
590 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
541 - `BetaManagedAgentsAlwaysAllowPolicy object`
591542
592543 Tool calls are automatically approved without user confirmation.
593544
594 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
545 - `BetaManagedAgentsAlwaysAskPolicy object`
595546
596547 Tool calls require user confirmation before execution.
597548
598549 - `type: "agent_toolset_20260401"`
599550
600 - `"agent_toolset_20260401"`
551 - `BetaManagedAgentsMCPToolset object`
601552
602 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
603
604553 - `configs: array of BetaManagedAgentsMCPToolConfig`
605554
606555 - `enabled: boolean`
from line 560
611560
612561 Permission policy for tool execution.
613562
614 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
563 - `BetaManagedAgentsAlwaysAllowPolicy object`
615564
616565 Tool calls are automatically approved without user confirmation.
617566
618 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
567 - `BetaManagedAgentsAlwaysAskPolicy object`
619568
620569 Tool calls require user confirmation before execution.
621570
from line 578
629578
630579 Permission policy for tool execution.
631580
632 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
581 - `BetaManagedAgentsAlwaysAllowPolicy object`
633582
634583 Tool calls are automatically approved without user confirmation.
635584
636 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
585 - `BetaManagedAgentsAlwaysAskPolicy object`
637586
638587 Tool calls require user confirmation before execution.
639588
from line 590
641590
642591 - `type: "mcp_toolset"`
643592
644 - `"mcp_toolset"`
593 - `BetaManagedAgentsCustomTool object`
645594
646 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`
647
648595 A custom tool as returned in API responses.
649596
650597 - `description: string`
from line 602
655602
656603 - `type: "object"`
657604
658 - `"object"`
659
660605 - `properties: optional map[unknown] or null`
661606
662607 - `required: optional array of string or null`
from line 610
665610
666611 - `type: "custom"`
667612
668 - `"custom"`
669
670613 - `type: "agent"`
671614
672 - `"agent"`
673
674615 - `updated_at: string`
675616
676617 A timestamp in RFC 3339 format
677618
619 format: date-time
620
678621 - `version: number`
679622
680623 The agent's current version. Starts at 1 and increments when the agent is modified.
681624
682### Example
625 format: int32
683626
684```http
627## Example
628
629```bash
685630curl https://api.anthropic.com/v1/agents/$AGENT_ID \
686631 -H 'anthropic-version: 2023-06-01' \
687632 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 633
688633 -H "X-Api-Key: $ANTHROPIC_API_KEY"
689634```
690635
691#### Response
636### Response (200)
692637
693638```json
694639{
No line in this hunk matches that.