Home Docs Claude Developer Platform 25 Aug 2026

One change · api

Agents changedapi/beta/agents

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 25 Aug 2026 03:37 UTC

Lines+1,020added

Lines−1,799removed

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

### Headers ### Body parameters #### Response (200) ### Query parameters ### Headers #### Response (200) ### Path parameters ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers ### Body parameters #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ## Agents › Versions ### List Agent Versions #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Header Parameters ### Body Parameters #### Response ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters ### Body Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types # Versions ## List Agent Versions ### Path Parameters ### Query Parameters ### Header Parameters #### Response

The whole hunk

from line 1, old and new numbered

lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.

from line 1

1---

2title: Agents

3url: https://platform.claude.com/docs/en/api/beta/agents

4---

61# Agents

83## Create Agent

10**post** `/v1/agents`

5**POST** `/v1/agents`

116

127Create Agent

138

14### Header Parameters

9### Headers

1510

1611- `"anthropic-beta": optional array of AnthropicBeta`

1712

from line 84

8984

9085 - `"mid-conversation-tool-changes-2026-07-01"`

9186

92### Body Parameters

87### Body parameters

9388

9489- `model: BetaManagedAgentsModel or BetaManagedAgentsModelConfigParams`

9590

from line 156

161156

162157 - `string`

163158

164 - `BetaManagedAgentsModelConfigParams object { id, effort, inference_geo, speed }`

159 - `BetaManagedAgentsModelConfigParams object`

165160

166161 An object that defines additional configuration control over model use

167162

from line 184

189184

190185 - `"max"`

191186

192 - `BetaManagedAgentsEffortLow object { type }`

187 - `BetaManagedAgentsEffortLow object`

193188

194189 Low effort. Favors latency over reasoning depth.

195190

196191 - `type: "low"`

197192

198 - `"low"`

199

200 - `BetaManagedAgentsEffortMedium object { type }`

193 - `BetaManagedAgentsEffortMedium object`

201194

202195 Medium effort. Balances latency and reasoning depth.

203196

204197 - `type: "medium"`

205198

206 - `"medium"`

207

208 - `BetaManagedAgentsEffortHigh object { type }`

199 - `BetaManagedAgentsEffortHigh object`

209200

210201 High effort. Favors reasoning depth.

211202

212203 - `type: "high"`

213204

214 - `"high"`

215

216 - `BetaManagedAgentsEffortXhigh object { type }`

205 - `BetaManagedAgentsEffortXhigh object`

217206

218207 Extra-high effort. Not all models accept this level.

219208

220209 - `type: "xhigh"`

221210

222 - `"xhigh"`

223

224 - `BetaManagedAgentsEffortMax object { type }`

211 - `BetaManagedAgentsEffortMax object`

225212

226213 Maximum effort. Favors reasoning depth over latency.

227214

228215 - `type: "max"`

229216

230 - `"max"`

231

232217 - `inference_geo: optional string or null`

233218

234219 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 230

245230

246231 Human-readable name for the agent.

247232

233 minLength: 1, maxLength: 256

234

248235- `description: optional string or null`

249236

250237 Description of what the agent does.

251238

239 maxLength: 2048

240

252241- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams`

253242

254243 MCP servers this agent connects to. Maximum 20. Names must be unique within the array. Every server must be referenced by an `mcp_toolset` in `tools`; unreferenced servers are rejected. See the [MCP connector guide](https://platform.claude.com/docs/en/managed-agents/mcp-connector).

from line 246

257246

258247 Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.

259248

249 minLength: 1, maxLength: 255

250

260251 - `type: "url"`

261252

262 - `"url"`

263

264253 - `url: string`

265254

266255 Endpoint URL for the MCP server.

267256

257 maxLength: 2048

258

268259- `metadata: optional map[string]`

269260

270261 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

from line 270

279270

280271 - `string`

281272

282 - `BetaManagedAgentsAgentParams object { id, type, version }`

273 - `BetaManagedAgentsAgentParams object`

283274

284275 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version

285276

from line 278

287278

288279 The `agent` ID.

289280

281 minLength: 1, maxLength: 128

282

290283 - `type: "agent"`

291284

292 - `"agent"`

293

294285 - `version: optional number`

295286

296287 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.

297288

298 - `BetaManagedAgentsMultiagentSelfParams object { type }`

289 format: int32

290

291 - `BetaManagedAgentsMultiagentSelfParams object`

299292

300293 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.

301294

302295 - `type: "self"`

303296

304 - `"self"`

305

306 - `BetaManagedAgentsAdvisorParams object { model, type }`

297 - `BetaManagedAgentsAdvisorParams object`

307298

308299 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`.

309300

from line 302

311302

312303 A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.

313304

305 minLength: 1, maxLength: 256

306

314307 - `type: "advisor"`

315308

316 - `"advisor"`

317

318309 - `type: "coordinator"`

319310

320 - `"coordinator"`

321

322311- `skills: optional array of BetaManagedAgentsSkillParams`

323312

324313 Skills available to the agent.

325314

326 - `BetaManagedAgentsAnthropicSkillParams object { skill_id, type, version }`

315 - `BetaManagedAgentsAnthropicSkillParams object`

327316

328317 An Anthropic-managed skill.

329318

from line 320

331320

332321 Identifier of the Anthropic skill (e.g., "xlsx").

333322

323 minLength: 1, maxLength: 64

324

334325 - `type: "anthropic"`

335326

336 - `"anthropic"`

337

338327 - `version: optional string or null`

339328

340329 Version to pin. Defaults to latest if omitted.

341330

342 - `BetaManagedAgentsCustomSkillParams object { skill_id, type, version }`

331 minLength: 1, maxLength: 64

332

333 - `BetaManagedAgentsCustomSkillParams object`

343334

344335 A user-created custom skill.

345336

from line 338

347338

348339 Tagged ID of the custom skill (e.g., "skill_01XJ5...").

349340

341 minLength: 1, maxLength: 64

342

350343 - `type: "custom"`

351344

352 - `"custom"`

353

354345 - `version: optional string or null`

355346

356347 Version to pin. Defaults to latest if omitted.

357348

349 minLength: 1, maxLength: 64

350

358351- `system: optional string or null`

359352

360353 System prompt for the agent.

361354

355 maxLength: 100000

356

362357- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams`

363358

364359 Tool configurations available to the agent. Maximum of 128 tools across all toolsets allowed.

365360

366 - `BetaManagedAgentsAgentToolset20260401Params object { type, configs, default_config }`

361 - `BetaManagedAgentsAgentToolset20260401Params object`

367362

368363 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.

369364

370365 - `type: "agent_toolset_20260401"`

371366

372 - `"agent_toolset_20260401"`

373

374367 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`

375368

376369 Per-tool configuration overrides.

377370

378 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`

371 - `BetaManagedAgentsBashToolConfigParams object`

379372

380373 Configuration override for the bash tool.

381374

from line 376

383376

384377 Must be "bash".

385378

386 - `"bash"`

387

388379 - `enabled: optional boolean or null`

389380

390381 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 384

393384

394385 Permission policy for tool execution.

395386

396 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

387 - `BetaManagedAgentsAlwaysAllowPolicy object`

397388

398389 Tool calls are automatically approved without user confirmation.

399390

400391 - `type: "always_allow"`

401392

402 - `"always_allow"`

403

404 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

393 - `BetaManagedAgentsAlwaysAskPolicy object`

405394

406395 Tool calls require user confirmation before execution.

407396

408397 - `type: "always_ask"`

409398

410 - `"always_ask"`

411

412399 - `type: optional "bash"`

413400

414 - `"bash"`

415

416 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`

401 - `BetaManagedAgentsEditToolConfigParams object`

417402

418403 Configuration override for the edit tool.

419404

from line 406

421406

422407 Must be "edit".

423408

424 - `"edit"`

425

426409 - `enabled: optional boolean or null`

427410

428411 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 414

431414

432415 Permission policy for tool execution.

433416

434 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

417 - `BetaManagedAgentsAlwaysAllowPolicy object`

435418

436419 Tool calls are automatically approved without user confirmation.

437420

438 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

421 - `BetaManagedAgentsAlwaysAskPolicy object`

439422

440423 Tool calls require user confirmation before execution.

441424

442425 - `type: optional "edit"`

443426

444 - `"edit"`

445

446 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`

427 - `BetaManagedAgentsReadToolConfigParams object`

447428

448429 Configuration override for the read tool.

449430

from line 432

451432

452433 Must be "read".

453434

454 - `"read"`

455

456435 - `enabled: optional boolean or null`

457436

458437 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 440

461440

462441 Permission policy for tool execution.

463442

464 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

443 - `BetaManagedAgentsAlwaysAllowPolicy object`

465444

466445 Tool calls are automatically approved without user confirmation.

467446

468 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

447 - `BetaManagedAgentsAlwaysAskPolicy object`

469448

470449 Tool calls require user confirmation before execution.

471450

472451 - `type: optional "read"`

473452

474 - `"read"`

475

476 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`

453 - `BetaManagedAgentsWriteToolConfigParams object`

477454

478455 Configuration override for the write tool.

479456

from line 458

481458

482459 Must be "write".

483460

484 - `"write"`

485

486461 - `enabled: optional boolean or null`

487462

488463 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 466

491466

492467 Permission policy for tool execution.

493468

494 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

469 - `BetaManagedAgentsAlwaysAllowPolicy object`

495470

496471 Tool calls are automatically approved without user confirmation.

497472

498 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

473 - `BetaManagedAgentsAlwaysAskPolicy object`

499474

500475 Tool calls require user confirmation before execution.

501476

502477 - `type: optional "write"`

503478

504 - `"write"`

505

506 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`

479 - `BetaManagedAgentsGlobToolConfigParams object`

507480

508481 Configuration override for the glob tool.

509482

from line 484

511484

512485 Must be "glob".

513486

514 - `"glob"`

515

516487 - `enabled: optional boolean or null`

517488

518489 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 492

521492

522493 Permission policy for tool execution.

523494

524 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

495 - `BetaManagedAgentsAlwaysAllowPolicy object`

525496

526497 Tool calls are automatically approved without user confirmation.

527498

528 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

499 - `BetaManagedAgentsAlwaysAskPolicy object`

529500

530501 Tool calls require user confirmation before execution.

531502

532503 - `type: optional "glob"`

533504

534 - `"glob"`

535

536 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`

505 - `BetaManagedAgentsGrepToolConfigParams object`

537506

538507 Configuration override for the grep tool.

539508

from line 510

541510

542511 Must be "grep".

543512

544 - `"grep"`

545

546513 - `enabled: optional boolean or null`

547514

548515 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 518

551518

552519 Permission policy for tool execution.

553520

554 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

521 - `BetaManagedAgentsAlwaysAllowPolicy object`

555522

556523 Tool calls are automatically approved without user confirmation.

557524

558 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

525 - `BetaManagedAgentsAlwaysAskPolicy object`

559526

560527 Tool calls require user confirmation before execution.

561528

562529 - `type: optional "grep"`

563530

564 - `"grep"`

565

566 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

531 - `BetaManagedAgentsWebFetchToolConfigParams object`

567532

568533 Configuration override for the web_fetch tool.

569534

from line 536

571536

572537 Must be "web_fetch".

573538

574 - `"web_fetch"`

575

576539 - `allowed_domains: optional array of string`

577540

578541 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 552

589552

590553 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

591554

555 format: int32

556

592557 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`

593558

594559 Permission policy for tool execution.

595560

596 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

561 - `BetaManagedAgentsAlwaysAllowPolicy object`

597562

598563 Tool calls are automatically approved without user confirmation.

599564

600 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

565 - `BetaManagedAgentsAlwaysAskPolicy object`

601566

602567 Tool calls require user confirmation before execution.

603568

604569 - `type: optional "web_fetch"`

605570

606 - `"web_fetch"`

607

608 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

571 - `BetaManagedAgentsWebSearchToolConfigParams object`

609572

610573 Configuration override for the web_search tool.

611574

from line 576

613576

614577 Must be "web_search".

615578

616 - `"web_search"`

617

618579 - `allowed_domains: optional array of string`

619580

620581 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 592

631592

632593 Permission policy for tool execution.

633594

634 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

595 - `BetaManagedAgentsAlwaysAllowPolicy object`

635596

636597 Tool calls are automatically approved without user confirmation.

637598

638 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

599 - `BetaManagedAgentsAlwaysAskPolicy object`

639600

640601 Tool calls require user confirmation before execution.

641602

642603 - `type: optional "web_search"`

643604

644 - `"web_search"`

645

646605 - `user_location: optional BetaManagedAgentsUserLocation or null`

647606

648607 Approximate user location for search result localization.

from line 610

651610

652611 Location precision. Only "approximate" is supported.

653612

654 - `"approximate"`

655

656613 - `city: optional string or null`

657614

658615 City name.

659616

617 minLength: 1, maxLength: 255

618

660619 - `country: optional string or null`

661620

662621 Two-letter ISO 3166-1 country code, uppercase.

from line 624

665624

666625 Region or state name.

667626

627 minLength: 1, maxLength: 255

628

668629 - `timezone: optional string or null`

669630

670631 IANA timezone identifier, e.g. "America/Los_Angeles".

671632

633 minLength: 1, maxLength: 255

634

672635 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`

673636

674637 Default configuration for all tools in a toolset.

from line 644

681644

682645 Permission policy for tool execution.

683646

684 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

647 - `BetaManagedAgentsAlwaysAllowPolicy object`

685648

686649 Tool calls are automatically approved without user confirmation.

687650

688 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

651 - `BetaManagedAgentsAlwaysAskPolicy object`

689652

690653 Tool calls require user confirmation before execution.

691654

692 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`

655 - `BetaManagedAgentsMCPToolsetParams object`

693656

694657 Configuration for tools from an MCP server defined in `mcp_servers`.

695658

from line 660

697660

698661 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.

699662

663 minLength: 1, maxLength: 255

664

700665 - `type: "mcp_toolset"`

701666

702 - `"mcp_toolset"`

703

704667 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`

705668

706669 Per-tool configuration overrides.

from line 672

709672

710673 Name of the MCP tool to configure. 1-128 characters.

711674

675 minLength: 1, maxLength: 128

676

712677 - `enabled: optional boolean or null`

713678

714679 Whether this tool is enabled. Overrides the `default_config` setting.

from line 682

717682

718683 Permission policy for tool execution.

719684

720 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

685 - `BetaManagedAgentsAlwaysAllowPolicy object`

721686

722687 Tool calls are automatically approved without user confirmation.

723688

724 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

689 - `BetaManagedAgentsAlwaysAskPolicy object`

725690

726691 Tool calls require user confirmation before execution.

727692

from line 702

737702

738703 Permission policy for tool execution.

739704

740 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

705 - `BetaManagedAgentsAlwaysAllowPolicy object`

741706

742707 Tool calls are automatically approved without user confirmation.

743708

744 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

709 - `BetaManagedAgentsAlwaysAskPolicy object`

745710

746711 Tool calls require user confirmation before execution.

747712

748 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`

713 - `BetaManagedAgentsCustomToolParams object`

749714

750715 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.

751716

from line 718

753718

754719 Description of what the tool does, shown to the agent to help it decide when to use the tool.

755720

721 minLength: 1

722

756723 - `input_schema: BetaManagedAgentsCustomToolInputSchema`

757724

758725 JSON Schema for custom tool input parameters.

759726

760727 - `type: "object"`

761728

762 - `"object"`

763

764729 - `properties: optional map[unknown] or null`

765730

766731 - `required: optional array of string or null`

from line 734

769734

770735 Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.

771736

737 minLength: 1, maxLength: 128

738

772739 - `type: "custom"`

773740

774 - `"custom"`

775

776741### Returns

777742

778- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`

743- `BetaManagedAgentsAgent object`

779744

780745 A Managed Agents `agent`.

781746

from line 750

785750

786751 A timestamp in RFC 3339 format

787752

753 format: date-time

754

788755 - `created_at: string`

789756

790757 A timestamp in RFC 3339 format

791758

759 format: date-time

760

792761 - `description: string or null`

793762

794763 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 766

797766

798767 - `type: "url"`

799768

800 - `"url"`

801

802769 - `url: string`

803770

804771 - `metadata: map[string]`

from line 844

877844

878845 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

879846

880 - `BetaManagedAgentsEffortLow object { type }`

847 - `BetaManagedAgentsEffortLow object`

881848

882849 Low effort. Favors latency over reasoning depth.

883850

884851 - `type: "low"`

885852

886 - `"low"`

887

888 - `BetaManagedAgentsEffortMedium object { type }`

853 - `BetaManagedAgentsEffortMedium object`

889854

890855 Medium effort. Balances latency and reasoning depth.

891856

892857 - `type: "medium"`

893858

894 - `"medium"`

895

896 - `BetaManagedAgentsEffortHigh object { type }`

859 - `BetaManagedAgentsEffortHigh object`

897860

898861 High effort. Favors reasoning depth.

899862

900863 - `type: "high"`

901864

902 - `"high"`

903

904 - `BetaManagedAgentsEffortXhigh object { type }`

865 - `BetaManagedAgentsEffortXhigh object`

905866

906867 Extra-high effort. Not all models accept this level.

907868

908869 - `type: "xhigh"`

909870

910 - `"xhigh"`

911

912 - `BetaManagedAgentsEffortMax object { type }`

871 - `BetaManagedAgentsEffortMax object`

913872

914873 Maximum effort. Favors reasoning depth over latency.

915874

916875 - `type: "max"`

917876

918 - `"max"`

919

920877 - `inference_geo: optional string`

921878

922879 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 894

937894

938895 Agents the coordinator may spawn as session threads, each resolved to a specific version.

939896

940 - `BetaManagedAgentsAgentReference object { id, type, version }`

897 - `BetaManagedAgentsAgentReference object`

941898

942899 A resolved agent reference with a concrete version.

943900

from line 902

945902

946903 - `type: "agent"`

947904

948 - `"agent"`

949

950905 - `version: number`

951906

952 - `BetaManagedAgentsAdvisor object { model, type }`

907 format: int32

908

909 - `BetaManagedAgentsAdvisor object`

953910

954911 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

955912

from line 916

959916

960917 - `type: "advisor"`

961918

962 - `"advisor"`

963

964919 - `type: "coordinator"`

965920

966 - `"coordinator"`

967

968921 - `name: string`

969922

970923 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

971924

972 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

925 - `BetaManagedAgentsAnthropicSkill object`

973926

974927 A resolved Anthropic-managed skill.

975928

from line 930

977930

978931 - `type: "anthropic"`

979932

980 - `"anthropic"`

981

982933 - `version: string`

983934

984 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

935 - `BetaManagedAgentsCustomSkill object`

985936

986937 A resolved user-created custom skill.

987938

from line 940

989940

990941 - `type: "custom"`

991942

992 - `"custom"`

993

994943 - `version: string`

995944

996945 - `system: string or null`

997946

998947 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

999948

1000 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

949 - `BetaManagedAgentsAgentToolset20260401 object`

1001950

1002951 - `configs: array of BetaManagedAgentsAgentToolConfig`

1003952

1004 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

953 - `BetaManagedAgentsBashToolConfig object`

1005954

1006955 Configuration for the bash tool.

1007956

from line 958

1009958

1010959 - `name: "bash"`

1011960

1012 - `"bash"`

1013

1014961 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

1015962

1016963 Permission policy for tool execution.

1017964

1018 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

965 - `BetaManagedAgentsAlwaysAllowPolicy object`

1019966

1020967 Tool calls are automatically approved without user confirmation.

1021968

1022969 - `type: "always_allow"`

1023970

1024 - `"always_allow"`

1025

1026 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

971 - `BetaManagedAgentsAlwaysAskPolicy object`

1027972

1028973 Tool calls require user confirmation before execution.

1029974

1030975 - `type: "always_ask"`

1031976

1032 - `"always_ask"`

1033

1034977 - `type: "bash"`

1035978

1036 - `"bash"`

1037

1038 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

979 - `BetaManagedAgentsEditToolConfig object`

1039980

1040981 Configuration for the edit tool.

1041982

from line 984

1043984

1044985 - `name: "edit"`

1045986

1046 - `"edit"`

1047

1048987 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

1049988

1050989 Permission policy for tool execution.

1051990

1052 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

991 - `BetaManagedAgentsAlwaysAllowPolicy object`

1053992

1054993 Tool calls are automatically approved without user confirmation.

1055994

1056 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

995 - `BetaManagedAgentsAlwaysAskPolicy object`

1057996

1058997 Tool calls require user confirmation before execution.

1059998

1060999 - `type: "edit"`

10611000

1062 - `"edit"`

1063

1064 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

1001 - `BetaManagedAgentsReadToolConfig object`

10651002

10661003 Configuration for the read tool.

10671004

from line 1006

10691006

10701007 - `name: "read"`

10711008

1072 - `"read"`

1073

10741009 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

10751010

10761011 Permission policy for tool execution.

10771012

1078 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1013 - `BetaManagedAgentsAlwaysAllowPolicy object`

10791014

10801015 Tool calls are automatically approved without user confirmation.

10811016

1082 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1017 - `BetaManagedAgentsAlwaysAskPolicy object`

10831018

10841019 Tool calls require user confirmation before execution.

10851020

10861021 - `type: "read"`

10871022

1088 - `"read"`

1089

1090 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

1023 - `BetaManagedAgentsWriteToolConfig object`

10911024

10921025 Configuration for the write tool.

10931026

from line 1028

10951028

10961029 - `name: "write"`

10971030

1098 - `"write"`

1099

11001031 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

11011032

11021033 Permission policy for tool execution.

11031034

1104 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1035 - `BetaManagedAgentsAlwaysAllowPolicy object`

11051036

11061037 Tool calls are automatically approved without user confirmation.

11071038

1108 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1039 - `BetaManagedAgentsAlwaysAskPolicy object`

11091040

11101041 Tool calls require user confirmation before execution.

11111042

11121043 - `type: "write"`

11131044

1114 - `"write"`

1115

1116 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

1045 - `BetaManagedAgentsGlobToolConfig object`

11171046

11181047 Configuration for the glob tool.

11191048

from line 1050

11211050

11221051 - `name: "glob"`

11231052

1124 - `"glob"`

1125

11261053 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

11271054

11281055 Permission policy for tool execution.

11291056

1130 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1057 - `BetaManagedAgentsAlwaysAllowPolicy object`

11311058

11321059 Tool calls are automatically approved without user confirmation.

11331060

1134 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1061 - `BetaManagedAgentsAlwaysAskPolicy object`

11351062

11361063 Tool calls require user confirmation before execution.

11371064

11381065 - `type: "glob"`

11391066

1140 - `"glob"`

1141

1142 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

1067 - `BetaManagedAgentsGrepToolConfig object`

11431068

11441069 Configuration for the grep tool.

11451070

from line 1072

11471072

11481073 - `name: "grep"`

11491074

1150 - `"grep"`

1151

11521075 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

11531076

11541077 Permission policy for tool execution.

11551078

1156 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1079 - `BetaManagedAgentsAlwaysAllowPolicy object`

11571080

11581081 Tool calls are automatically approved without user confirmation.

11591082

1160 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1083 - `BetaManagedAgentsAlwaysAskPolicy object`

11611084

11621085 Tool calls require user confirmation before execution.

11631086

11641087 - `type: "grep"`

11651088

1166 - `"grep"`

1167

1168 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

1089 - `BetaManagedAgentsWebFetchToolConfig object`

11691090

11701091 Configuration for the web_fetch tool.

11711092

from line 1094

11731094

11741095 - `name: "web_fetch"`

11751096

1176 - `"web_fetch"`

1177

11781097 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

11791098

11801099 Permission policy for tool execution.

11811100

1182 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1101 - `BetaManagedAgentsAlwaysAllowPolicy object`

11831102

11841103 Tool calls are automatically approved without user confirmation.

11851104

1186 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1105 - `BetaManagedAgentsAlwaysAskPolicy object`

11871106

11881107 Tool calls require user confirmation before execution.

11891108

11901109 - `type: "web_fetch"`

11911110

1192 - `"web_fetch"`

1193

11941111 - `allowed_domains: optional array of string`

11951112

11961113 - `blocked_domains: optional array of string`

11971114

11981115 - `max_content_tokens: optional number or null`

11991116

1200 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

1117 format: int32

1118

1119 - `BetaManagedAgentsWebSearchToolConfig object`

12011120

12021121 Configuration for the web_search tool.

12031122

from line 1124

12051124

12061125 - `name: "web_search"`

12071126

1208 - `"web_search"`

1209

12101127 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

12111128

12121129 Permission policy for tool execution.

12131130

1214 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1131 - `BetaManagedAgentsAlwaysAllowPolicy object`

12151132

12161133 Tool calls are automatically approved without user confirmation.

12171134

1218 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1135 - `BetaManagedAgentsAlwaysAskPolicy object`

12191136

12201137 Tool calls require user confirmation before execution.

12211138

12221139 - `type: "web_search"`

12231140

1224 - `"web_search"`

1225

12261141 - `allowed_domains: optional array of string`

12271142

12281143 - `blocked_domains: optional array of string`

from line 1150

12351150

12361151 Location precision. Only "approximate" is supported.

12371152

1238 - `"approximate"`

1239

12401153 - `city: optional string or null`

12411154

12421155 City name.

12431156

1157 minLength: 1, maxLength: 255

1158

12441159 - `country: optional string or null`

12451160

12461161 Two-letter ISO 3166-1 country code, uppercase.

from line 1164

12491164

12501165 Region or state name.

12511166

1167 minLength: 1, maxLength: 255

1168

12521169 - `timezone: optional string or null`

12531170

12541171 IANA timezone identifier, e.g. "America/Los_Angeles".

12551172

1173 minLength: 1, maxLength: 255

1174

12561175 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

12571176

12581177 Resolved default configuration for agent tools.

from line 1182

12631182

12641183 Permission policy for tool execution.

12651184

1266 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1185 - `BetaManagedAgentsAlwaysAllowPolicy object`

12671186

12681187 Tool calls are automatically approved without user confirmation.

12691188

1270 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1189 - `BetaManagedAgentsAlwaysAskPolicy object`

12711190

12721191 Tool calls require user confirmation before execution.

12731192

12741193 - `type: "agent_toolset_20260401"`

12751194

1276 - `"agent_toolset_20260401"`

1277

1278 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

1195 - `BetaManagedAgentsMCPToolset object`

12791196

12801197 - `configs: array of BetaManagedAgentsMCPToolConfig`

12811198

from line 1204

12871204

12881205 Permission policy for tool execution.

12891206

1290 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1207 - `BetaManagedAgentsAlwaysAllowPolicy object`

12911208

12921209 Tool calls are automatically approved without user confirmation.

12931210

1294 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1211 - `BetaManagedAgentsAlwaysAskPolicy object`

12951212

12961213 Tool calls require user confirmation before execution.

12971214

from line 1222

13051222

13061223 Permission policy for tool execution.

13071224

1308 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1225 - `BetaManagedAgentsAlwaysAllowPolicy object`

13091226

13101227 Tool calls are automatically approved without user confirmation.

13111228

1312 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1229 - `BetaManagedAgentsAlwaysAskPolicy object`

13131230

13141231 Tool calls require user confirmation before execution.

13151232

from line 1234

13171234

13181235 - `type: "mcp_toolset"`

13191236

1320 - `"mcp_toolset"`

1321

1322 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

1237 - `BetaManagedAgentsCustomTool object`

13231238

13241239 A custom tool as returned in API responses.

13251240

from line 1246

13311246

13321247 - `type: "object"`

13331248

1334 - `"object"`

1335

13361249 - `properties: optional map[unknown] or null`

13371250

13381251 - `required: optional array of string or null`

from line 1254

13411254

13421255 - `type: "custom"`

13431256

1344 - `"custom"`

1345

13461257 - `type: "agent"`

13471258

1348 - `"agent"`

1349

13501259 - `updated_at: string`

13511260

13521261 A timestamp in RFC 3339 format

13531262

1263 format: date-time

1264

13541265 - `version: number`

13551266

13561267 The agent's current version. Starts at 1 and increments when the agent is modified.

13571268

1269 format: int32

1270

13581271### Example

13591272

1360```http

1273```bash

13611274curl https://api.anthropic.com/v1/agents \

13621275 -H 'Content-Type: application/json' \

13631276 -H 'anthropic-version: 2023-06-01' \

from line 1292

13791292 }'

13801293```

13811294

1382#### Response

1295#### Response (200)

13831296

13841297```json

13851298{

from line 1371

14581371

14591372## List Agents

14601373

1461**get** `/v1/agents`

1374**GET** `/v1/agents`

14621375

14631376List Agents

14641377

1465### Query Parameters

1378### Query parameters

14661379

14671380- `"created_at[gte]": optional string`

14681381

14691382 Return agents created at or after this time (inclusive).

14701383

1384 format: date-time

1385

14711386- `"created_at[lte]": optional string`

14721387

14731388 Return agents created at or before this time (inclusive).

14741389

1390 format: date-time

1391

14751392- `include_archived: optional boolean`

14761393

14771394 Include archived agents in results. Defaults to false.

from line 1397

14801397

14811398 Maximum results per page. Default 20, maximum 100.

14821399

1400 format: int32

1401

14831402- `page: optional string`

14841403

14851404 Opaque pagination cursor from a previous response.

14861405

1487### Header Parameters

1406### Headers

14881407

14891408- `"anthropic-beta": optional array of AnthropicBeta`

14901409

from line 1493

15741493

15751494 A timestamp in RFC 3339 format

15761495

1496 format: date-time

1497

15771498 - `created_at: string`

15781499

15791500 A timestamp in RFC 3339 format

15801501

1502 format: date-time

1503

15811504 - `description: string or null`

15821505

15831506 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 1509

15861509

15871510 - `type: "url"`

15881511

1589 - `"url"`

1590

15911512 - `url: string`

15921513

15931514 - `metadata: map[string]`

from line 1587

16661587

16671588 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

16681589

1669 - `BetaManagedAgentsEffortLow object { type }`

1590 - `BetaManagedAgentsEffortLow object`

16701591

16711592 Low effort. Favors latency over reasoning depth.

16721593

16731594 - `type: "low"`

16741595

1675 - `"low"`

1676

1677 - `BetaManagedAgentsEffortMedium object { type }`

1596 - `BetaManagedAgentsEffortMedium object`

16781597

16791598 Medium effort. Balances latency and reasoning depth.

16801599

16811600 - `type: "medium"`

16821601

1683 - `"medium"`

1684

1685 - `BetaManagedAgentsEffortHigh object { type }`

1602 - `BetaManagedAgentsEffortHigh object`

16861603

16871604 High effort. Favors reasoning depth.

16881605

16891606 - `type: "high"`

16901607

1691 - `"high"`

1692

1693 - `BetaManagedAgentsEffortXhigh object { type }`

1608 - `BetaManagedAgentsEffortXhigh object`

16941609

16951610 Extra-high effort. Not all models accept this level.

16961611

16971612 - `type: "xhigh"`

16981613

1699 - `"xhigh"`

1700

1701 - `BetaManagedAgentsEffortMax object { type }`

1614 - `BetaManagedAgentsEffortMax object`

17021615

17031616 Maximum effort. Favors reasoning depth over latency.

17041617

17051618 - `type: "max"`

17061619

1707 - `"max"`

1708

17091620 - `inference_geo: optional string`

17101621

17111622 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 1637

17261637

17271638 Agents the coordinator may spawn as session threads, each resolved to a specific version.

17281639

1729 - `BetaManagedAgentsAgentReference object { id, type, version }`

1640 - `BetaManagedAgentsAgentReference object`

17301641

17311642 A resolved agent reference with a concrete version.

17321643

from line 1645

17341645

17351646 - `type: "agent"`

17361647

1737 - `"agent"`

1738

17391648 - `version: number`

17401649

1741 - `BetaManagedAgentsAdvisor object { model, type }`

1650 format: int32

1651

1652 - `BetaManagedAgentsAdvisor object`

17421653

17431654 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

17441655

from line 1659

17481659

17491660 - `type: "advisor"`

17501661

1751 - `"advisor"`

1752

17531662 - `type: "coordinator"`

17541663

1755 - `"coordinator"`

1756

17571664 - `name: string`

17581665

17591666 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

17601667

1761 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

1668 - `BetaManagedAgentsAnthropicSkill object`

17621669

17631670 A resolved Anthropic-managed skill.

17641671

from line 1673

17661673

17671674 - `type: "anthropic"`

17681675

1769 - `"anthropic"`

1770

17711676 - `version: string`

17721677

1773 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

1678 - `BetaManagedAgentsCustomSkill object`

17741679

17751680 A resolved user-created custom skill.

17761681

from line 1683

17781683

17791684 - `type: "custom"`

17801685

1781 - `"custom"`

1782

17831686 - `version: string`

17841687

17851688 - `system: string or null`

17861689

17871690 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

17881691

1789 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

1692 - `BetaManagedAgentsAgentToolset20260401 object`

17901693

17911694 - `configs: array of BetaManagedAgentsAgentToolConfig`

17921695

1793 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

1696 - `BetaManagedAgentsBashToolConfig object`

17941697

17951698 Configuration for the bash tool.

17961699

from line 1701

17981701

17991702 - `name: "bash"`

18001703

1801 - `"bash"`

1802

18031704 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

18041705

18051706 Permission policy for tool execution.

18061707

1807 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1708 - `BetaManagedAgentsAlwaysAllowPolicy object`

18081709

18091710 Tool calls are automatically approved without user confirmation.

18101711

18111712 - `type: "always_allow"`

18121713

1813 - `"always_allow"`

1814

1815 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1714 - `BetaManagedAgentsAlwaysAskPolicy object`

18161715

18171716 Tool calls require user confirmation before execution.

18181717

18191718 - `type: "always_ask"`

18201719

1821 - `"always_ask"`

1822

18231720 - `type: "bash"`

18241721

1825 - `"bash"`

1826

1827 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

1722 - `BetaManagedAgentsEditToolConfig object`

18281723

18291724 Configuration for the edit tool.

18301725

from line 1727

18321727

18331728 - `name: "edit"`

18341729

1835 - `"edit"`

1836

18371730 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

18381731

18391732 Permission policy for tool execution.

18401733

1841 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1734 - `BetaManagedAgentsAlwaysAllowPolicy object`

18421735

18431736 Tool calls are automatically approved without user confirmation.

18441737

1845 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1738 - `BetaManagedAgentsAlwaysAskPolicy object`

18461739

18471740 Tool calls require user confirmation before execution.

18481741

18491742 - `type: "edit"`

18501743

1851 - `"edit"`

1852

1853 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

1744 - `BetaManagedAgentsReadToolConfig object`

18541745

18551746 Configuration for the read tool.

18561747

from line 1749

18581749

18591750 - `name: "read"`

18601751

1861 - `"read"`

1862

18631752 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

18641753

18651754 Permission policy for tool execution.

18661755

1867 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1756 - `BetaManagedAgentsAlwaysAllowPolicy object`

18681757

18691758 Tool calls are automatically approved without user confirmation.

18701759

1871 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1760 - `BetaManagedAgentsAlwaysAskPolicy object`

18721761

18731762 Tool calls require user confirmation before execution.

18741763

18751764 - `type: "read"`

18761765

1877 - `"read"`

1878

1879 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

1766 - `BetaManagedAgentsWriteToolConfig object`

18801767

18811768 Configuration for the write tool.

18821769

from line 1771

18841771

18851772 - `name: "write"`

18861773

1887 - `"write"`

1888

18891774 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

18901775

18911776 Permission policy for tool execution.

18921777

1893 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1778 - `BetaManagedAgentsAlwaysAllowPolicy object`

18941779

18951780 Tool calls are automatically approved without user confirmation.

18961781

1897 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1782 - `BetaManagedAgentsAlwaysAskPolicy object`

18981783

18991784 Tool calls require user confirmation before execution.

19001785

19011786 - `type: "write"`

19021787

1903 - `"write"`

1904

1905 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

1788 - `BetaManagedAgentsGlobToolConfig object`

19061789

19071790 Configuration for the glob tool.

19081791

from line 1793

19101793

19111794 - `name: "glob"`

19121795

1913 - `"glob"`

1914

19151796 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

19161797

19171798 Permission policy for tool execution.

19181799

1919 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1800 - `BetaManagedAgentsAlwaysAllowPolicy object`

19201801

19211802 Tool calls are automatically approved without user confirmation.

19221803

1923 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1804 - `BetaManagedAgentsAlwaysAskPolicy object`

19241805

19251806 Tool calls require user confirmation before execution.

19261807

19271808 - `type: "glob"`

19281809

1929 - `"glob"`

1930

1931 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

1810 - `BetaManagedAgentsGrepToolConfig object`

19321811

19331812 Configuration for the grep tool.

19341813

from line 1815

19361815

19371816 - `name: "grep"`

19381817

1939 - `"grep"`

1940

19411818 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

19421819

19431820 Permission policy for tool execution.

19441821

1945 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1822 - `BetaManagedAgentsAlwaysAllowPolicy object`

19461823

19471824 Tool calls are automatically approved without user confirmation.

19481825

1949 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1826 - `BetaManagedAgentsAlwaysAskPolicy object`

19501827

19511828 Tool calls require user confirmation before execution.

19521829

19531830 - `type: "grep"`

19541831

1955 - `"grep"`

1956

1957 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

1832 - `BetaManagedAgentsWebFetchToolConfig object`

19581833

19591834 Configuration for the web_fetch tool.

19601835

from line 1837

19621837

19631838 - `name: "web_fetch"`

19641839

1965 - `"web_fetch"`

1966

19671840 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

19681841

19691842 Permission policy for tool execution.

19701843

1971 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1844 - `BetaManagedAgentsAlwaysAllowPolicy object`

19721845

19731846 Tool calls are automatically approved without user confirmation.

19741847

1975 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1848 - `BetaManagedAgentsAlwaysAskPolicy object`

19761849

19771850 Tool calls require user confirmation before execution.

19781851

19791852 - `type: "web_fetch"`

19801853

1981 - `"web_fetch"`

1982

19831854 - `allowed_domains: optional array of string`

19841855

19851856 - `blocked_domains: optional array of string`

19861857

19871858 - `max_content_tokens: optional number or null`

19881859

1989 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

1860 format: int32

1861

1862 - `BetaManagedAgentsWebSearchToolConfig object`

19901863

19911864 Configuration for the web_search tool.

19921865

from line 1867

19941867

19951868 - `name: "web_search"`

19961869

1997 - `"web_search"`

1998

19991870 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

20001871

20011872 Permission policy for tool execution.

20021873

2003 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1874 - `BetaManagedAgentsAlwaysAllowPolicy object`

20041875

20051876 Tool calls are automatically approved without user confirmation.

20061877

2007 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1878 - `BetaManagedAgentsAlwaysAskPolicy object`

20081879

20091880 Tool calls require user confirmation before execution.

20101881

20111882 - `type: "web_search"`

20121883

2013 - `"web_search"`

2014

20151884 - `allowed_domains: optional array of string`

20161885

20171886 - `blocked_domains: optional array of string`

from line 1893

20241893

20251894 Location precision. Only "approximate" is supported.

20261895

2027 - `"approximate"`

2028

20291896 - `city: optional string or null`

20301897

20311898 City name.

20321899

1900 minLength: 1, maxLength: 255

1901

20331902 - `country: optional string or null`

20341903

20351904 Two-letter ISO 3166-1 country code, uppercase.

from line 1907

20381907

20391908 Region or state name.

20401909

1910 minLength: 1, maxLength: 255

1911

20411912 - `timezone: optional string or null`

20421913

20431914 IANA timezone identifier, e.g. "America/Los_Angeles".

20441915

1916 minLength: 1, maxLength: 255

1917

20451918 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

20461919

20471920 Resolved default configuration for agent tools.

from line 1925

20521925

20531926 Permission policy for tool execution.

20541927

2055 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1928 - `BetaManagedAgentsAlwaysAllowPolicy object`

20561929

20571930 Tool calls are automatically approved without user confirmation.

20581931

2059 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1932 - `BetaManagedAgentsAlwaysAskPolicy object`

20601933

20611934 Tool calls require user confirmation before execution.

20621935

20631936 - `type: "agent_toolset_20260401"`

20641937

2065 - `"agent_toolset_20260401"`

2066

2067 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

1938 - `BetaManagedAgentsMCPToolset object`

20681939

20691940 - `configs: array of BetaManagedAgentsMCPToolConfig`

20701941

from line 1947

20761947

20771948 Permission policy for tool execution.

20781949

2079 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1950 - `BetaManagedAgentsAlwaysAllowPolicy object`

20801951

20811952 Tool calls are automatically approved without user confirmation.

20821953

2083 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1954 - `BetaManagedAgentsAlwaysAskPolicy object`

20841955

20851956 Tool calls require user confirmation before execution.

20861957

from line 1965

20941965

20951966 Permission policy for tool execution.

20961967

2097 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

1968 - `BetaManagedAgentsAlwaysAllowPolicy object`

20981969

20991970 Tool calls are automatically approved without user confirmation.

21001971

2101 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

1972 - `BetaManagedAgentsAlwaysAskPolicy object`

21021973

21031974 Tool calls require user confirmation before execution.

21041975

from line 1977

21061977

21071978 - `type: "mcp_toolset"`

21081979

2109 - `"mcp_toolset"`

2110

2111 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

1980 - `BetaManagedAgentsCustomTool object`

21121981

21131982 A custom tool as returned in API responses.

21141983

from line 1989

21201989

21211990 - `type: "object"`

21221991

2123 - `"object"`

2124

21251992 - `properties: optional map[unknown] or null`

21261993

21271994 - `required: optional array of string or null`

from line 1997

21301997

21311998 - `type: "custom"`

21321999

2133 - `"custom"`

2134

21352000 - `type: "agent"`

21362001

2137 - `"agent"`

2138

21392002 - `updated_at: string`

21402003

21412004 A timestamp in RFC 3339 format

21422005

2006 format: date-time

2007

21432008 - `version: number`

21442009

21452010 The agent's current version. Starts at 1 and increments when the agent is modified.

21462011

2012 format: int32

2013

21472014- `next_page: optional string or null`

21482015

21492016 Opaque cursor for the next page. Null when no more results.

21502017

21512018### Example

21522019

2153```http

2020```bash

21542021curl https://api.anthropic.com/v1/agents \

21552022 -H 'anthropic-version: 2023-06-01' \

21562023 -H 'anthropic-beta: managed-agents-2026-04-01' \

21572024 -H "X-Api-Key: $ANTHROPIC_API_KEY"

21582025```

21592026

2160#### Response

2027#### Response (200)

21612028

21622029```json

21632030{

from line 2108

22412108

22422109## Get Agent

22432110

2244**get** `/v1/agents/{agent_id}`

2111**GET** `/v1/agents/{agent_id}`

22452112

22462113Get Agent

22472114

2248### Path Parameters

2115### Path parameters

22492116

22502117- `agent_id: string`

22512118

2252### Query Parameters

2119### Query parameters

22532120

22542121- `version: optional number`

22552122

22562123 Agent version. Omit for the most recent version. Must be at least 1 if specified.

22572124

2258### Header Parameters

2125 format: int32

2126

2127### Headers

22592128

22602129- `"anthropic-beta": optional array of AnthropicBeta`

22612130

from line 2204

23352204

23362205### Returns

23372206

2338- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`

2207- `BetaManagedAgentsAgent object`

23392208

23402209 A Managed Agents `agent`.

23412210

from line 2214

23452214

23462215 A timestamp in RFC 3339 format

23472216

2217 format: date-time

2218

23482219 - `created_at: string`

23492220

23502221 A timestamp in RFC 3339 format

23512222

2223 format: date-time

2224

23522225 - `description: string or null`

23532226

23542227 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 2230

23572230

23582231 - `type: "url"`

23592232

2360 - `"url"`

2361

23622233 - `url: string`

23632234

23642235 - `metadata: map[string]`

from line 2308

24372308

24382309 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

24392310

2440 - `BetaManagedAgentsEffortLow object { type }`

2311 - `BetaManagedAgentsEffortLow object`

24412312

24422313 Low effort. Favors latency over reasoning depth.

24432314

24442315 - `type: "low"`

24452316

2446 - `"low"`

2447

2448 - `BetaManagedAgentsEffortMedium object { type }`

2317 - `BetaManagedAgentsEffortMedium object`

24492318

24502319 Medium effort. Balances latency and reasoning depth.

24512320

24522321 - `type: "medium"`

24532322

2454 - `"medium"`

2455

2456 - `BetaManagedAgentsEffortHigh object { type }`

2323 - `BetaManagedAgentsEffortHigh object`

24572324

24582325 High effort. Favors reasoning depth.

24592326

24602327 - `type: "high"`

24612328

2462 - `"high"`

2463

2464 - `BetaManagedAgentsEffortXhigh object { type }`

2329 - `BetaManagedAgentsEffortXhigh object`

24652330

24662331 Extra-high effort. Not all models accept this level.

24672332

24682333 - `type: "xhigh"`

24692334

2470 - `"xhigh"`

2471

2472 - `BetaManagedAgentsEffortMax object { type }`

2335 - `BetaManagedAgentsEffortMax object`

24732336

24742337 Maximum effort. Favors reasoning depth over latency.

24752338

24762339 - `type: "max"`

24772340

2478 - `"max"`

2479

24802341 - `inference_geo: optional string`

24812342

24822343 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 2358

24972358

24982359 Agents the coordinator may spawn as session threads, each resolved to a specific version.

24992360

2500 - `BetaManagedAgentsAgentReference object { id, type, version }`

2361 - `BetaManagedAgentsAgentReference object`

25012362

25022363 A resolved agent reference with a concrete version.

25032364

from line 2366

25052366

25062367 - `type: "agent"`

25072368

2508 - `"agent"`

2509

25102369 - `version: number`

25112370

2512 - `BetaManagedAgentsAdvisor object { model, type }`

2371 format: int32

2372

2373 - `BetaManagedAgentsAdvisor object`

25132374

25142375 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

25152376

from line 2380

25192380

25202381 - `type: "advisor"`

25212382

2522 - `"advisor"`

2523

25242383 - `type: "coordinator"`

25252384

2526 - `"coordinator"`

2527

25282385 - `name: string`

25292386

25302387 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

25312388

2532 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

2389 - `BetaManagedAgentsAnthropicSkill object`

25332390

25342391 A resolved Anthropic-managed skill.

25352392

from line 2394

25372394

25382395 - `type: "anthropic"`

25392396

2540 - `"anthropic"`

2541

25422397 - `version: string`

25432398

2544 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

2399 - `BetaManagedAgentsCustomSkill object`

25452400

25462401 A resolved user-created custom skill.

25472402

from line 2404

25492404

25502405 - `type: "custom"`

25512406

2552 - `"custom"`

2553

25542407 - `version: string`

25552408

25562409 - `system: string or null`

25572410

25582411 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

25592412

2560 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

2413 - `BetaManagedAgentsAgentToolset20260401 object`

25612414

25622415 - `configs: array of BetaManagedAgentsAgentToolConfig`

25632416

2564 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

2417 - `BetaManagedAgentsBashToolConfig object`

25652418

25662419 Configuration for the bash tool.

25672420

from line 2422

25692422

25702423 - `name: "bash"`

25712424

2572 - `"bash"`

2573

25742425 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

25752426

25762427 Permission policy for tool execution.

25772428

2578 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2429 - `BetaManagedAgentsAlwaysAllowPolicy object`

25792430

25802431 Tool calls are automatically approved without user confirmation.

25812432

25822433 - `type: "always_allow"`

25832434

2584 - `"always_allow"`

2585

2586 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2435 - `BetaManagedAgentsAlwaysAskPolicy object`

25872436

25882437 Tool calls require user confirmation before execution.

25892438

25902439 - `type: "always_ask"`

25912440

2592 - `"always_ask"`

2593

25942441 - `type: "bash"`

25952442

2596 - `"bash"`

2597

2598 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

2443 - `BetaManagedAgentsEditToolConfig object`

25992444

26002445 Configuration for the edit tool.

26012446

from line 2448

26032448

26042449 - `name: "edit"`

26052450

2606 - `"edit"`

2607

26082451 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

26092452

26102453 Permission policy for tool execution.

26112454

2612 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2455 - `BetaManagedAgentsAlwaysAllowPolicy object`

26132456

26142457 Tool calls are automatically approved without user confirmation.

26152458

2616 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2459 - `BetaManagedAgentsAlwaysAskPolicy object`

26172460

26182461 Tool calls require user confirmation before execution.

26192462

26202463 - `type: "edit"`

26212464

2622 - `"edit"`

2623

2624 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

2465 - `BetaManagedAgentsReadToolConfig object`

26252466

26262467 Configuration for the read tool.

26272468

from line 2470

26292470

26302471 - `name: "read"`

26312472

2632 - `"read"`

2633

26342473 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

26352474

26362475 Permission policy for tool execution.

26372476

2638 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2477 - `BetaManagedAgentsAlwaysAllowPolicy object`

26392478

26402479 Tool calls are automatically approved without user confirmation.

26412480

2642 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2481 - `BetaManagedAgentsAlwaysAskPolicy object`

26432482

26442483 Tool calls require user confirmation before execution.

26452484

26462485 - `type: "read"`

26472486

2648 - `"read"`

2649

2650 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

2487 - `BetaManagedAgentsWriteToolConfig object`

26512488

26522489 Configuration for the write tool.

26532490

from line 2492

26552492

26562493 - `name: "write"`

26572494

2658 - `"write"`

2659

26602495 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

26612496

26622497 Permission policy for tool execution.

26632498

2664 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2499 - `BetaManagedAgentsAlwaysAllowPolicy object`

26652500

26662501 Tool calls are automatically approved without user confirmation.

26672502

2668 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2503 - `BetaManagedAgentsAlwaysAskPolicy object`

26692504

26702505 Tool calls require user confirmation before execution.

26712506

26722507 - `type: "write"`

26732508

2674 - `"write"`

2675

2676 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

2509 - `BetaManagedAgentsGlobToolConfig object`

26772510

26782511 Configuration for the glob tool.

26792512

from line 2514

26812514

26822515 - `name: "glob"`

26832516

2684 - `"glob"`

2685

26862517 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

26872518

26882519 Permission policy for tool execution.

26892520

2690 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2521 - `BetaManagedAgentsAlwaysAllowPolicy object`

26912522

26922523 Tool calls are automatically approved without user confirmation.

26932524

2694 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2525 - `BetaManagedAgentsAlwaysAskPolicy object`

26952526

26962527 Tool calls require user confirmation before execution.

26972528

26982529 - `type: "glob"`

26992530

2700 - `"glob"`

2701

2702 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

2531 - `BetaManagedAgentsGrepToolConfig object`

27032532

27042533 Configuration for the grep tool.

27052534

from line 2536

27072536

27082537 - `name: "grep"`

27092538

2710 - `"grep"`

2711

27122539 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

27132540

27142541 Permission policy for tool execution.

27152542

2716 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2543 - `BetaManagedAgentsAlwaysAllowPolicy object`

27172544

27182545 Tool calls are automatically approved without user confirmation.

27192546

2720 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2547 - `BetaManagedAgentsAlwaysAskPolicy object`

27212548

27222549 Tool calls require user confirmation before execution.

27232550

27242551 - `type: "grep"`

27252552

2726 - `"grep"`

2727

2728 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

2553 - `BetaManagedAgentsWebFetchToolConfig object`

27292554

27302555 Configuration for the web_fetch tool.

27312556

from line 2558

27332558

27342559 - `name: "web_fetch"`

27352560

2736 - `"web_fetch"`

2737

27382561 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

27392562

27402563 Permission policy for tool execution.

27412564

2742 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2565 - `BetaManagedAgentsAlwaysAllowPolicy object`

27432566

27442567 Tool calls are automatically approved without user confirmation.

27452568

2746 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2569 - `BetaManagedAgentsAlwaysAskPolicy object`

27472570

27482571 Tool calls require user confirmation before execution.

27492572

27502573 - `type: "web_fetch"`

27512574

2752 - `"web_fetch"`

2753

27542575 - `allowed_domains: optional array of string`

27552576

27562577 - `blocked_domains: optional array of string`

27572578

27582579 - `max_content_tokens: optional number or null`

27592580

2760 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

2581 format: int32

2582

2583 - `BetaManagedAgentsWebSearchToolConfig object`

27612584

27622585 Configuration for the web_search tool.

27632586

from line 2588

27652588

27662589 - `name: "web_search"`

27672590

2768 - `"web_search"`

2769

27702591 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

27712592

27722593 Permission policy for tool execution.

27732594

2774 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2595 - `BetaManagedAgentsAlwaysAllowPolicy object`

27752596

27762597 Tool calls are automatically approved without user confirmation.

27772598

2778 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2599 - `BetaManagedAgentsAlwaysAskPolicy object`

27792600

27802601 Tool calls require user confirmation before execution.

27812602

27822603 - `type: "web_search"`

27832604

2784 - `"web_search"`

2785

27862605 - `allowed_domains: optional array of string`

27872606

27882607 - `blocked_domains: optional array of string`

from line 2614

27952614

27962615 Location precision. Only "approximate" is supported.

27972616

2798 - `"approximate"`

2799

28002617 - `city: optional string or null`

28012618

28022619 City name.

28032620

2621 minLength: 1, maxLength: 255

2622

28042623 - `country: optional string or null`

28052624

28062625 Two-letter ISO 3166-1 country code, uppercase.

from line 2628

28092628

28102629 Region or state name.

28112630

2631 minLength: 1, maxLength: 255

2632

28122633 - `timezone: optional string or null`

28132634

28142635 IANA timezone identifier, e.g. "America/Los_Angeles".

28152636

2637 minLength: 1, maxLength: 255

2638

28162639 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

28172640

28182641 Resolved default configuration for agent tools.

from line 2646

28232646

28242647 Permission policy for tool execution.

28252648

2826 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2649 - `BetaManagedAgentsAlwaysAllowPolicy object`

28272650

28282651 Tool calls are automatically approved without user confirmation.

28292652

2830 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2653 - `BetaManagedAgentsAlwaysAskPolicy object`

28312654

28322655 Tool calls require user confirmation before execution.

28332656

28342657 - `type: "agent_toolset_20260401"`

28352658

2836 - `"agent_toolset_20260401"`

2837

2838 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

2659 - `BetaManagedAgentsMCPToolset object`

28392660

28402661 - `configs: array of BetaManagedAgentsMCPToolConfig`

28412662

from line 2668

28472668

28482669 Permission policy for tool execution.

28492670

2850 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2671 - `BetaManagedAgentsAlwaysAllowPolicy object`

28512672

28522673 Tool calls are automatically approved without user confirmation.

28532674

2854 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2675 - `BetaManagedAgentsAlwaysAskPolicy object`

28552676

28562677 Tool calls require user confirmation before execution.

28572678

from line 2686

28652686

28662687 Permission policy for tool execution.

28672688

2868 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

2689 - `BetaManagedAgentsAlwaysAllowPolicy object`

28692690

28702691 Tool calls are automatically approved without user confirmation.

28712692

2872 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

2693 - `BetaManagedAgentsAlwaysAskPolicy object`

28732694

28742695 Tool calls require user confirmation before execution.

28752696

from line 2698

28772698

28782699 - `type: "mcp_toolset"`

28792700

2880 - `"mcp_toolset"`

2881

2882 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

2701 - `BetaManagedAgentsCustomTool object`

28832702

28842703 A custom tool as returned in API responses.

28852704

from line 2710

28912710

28922711 - `type: "object"`

28932712

2894 - `"object"`

2895

28962713 - `properties: optional map[unknown] or null`

28972714

28982715 - `required: optional array of string or null`

from line 2718

29012718

29022719 - `type: "custom"`

29032720

2904 - `"custom"`

2905

29062721 - `type: "agent"`

29072722

2908 - `"agent"`

2909

29102723 - `updated_at: string`

29112724

29122725 A timestamp in RFC 3339 format

29132726

2727 format: date-time

2728

29142729 - `version: number`

29152730

29162731 The agent's current version. Starts at 1 and increments when the agent is modified.

29172732

2733 format: int32

2734

29182735### Example

29192736

2920```http

2737```bash

29212738curl https://api.anthropic.com/v1/agents/$AGENT_ID \

29222739 -H 'anthropic-version: 2023-06-01' \

29232740 -H 'anthropic-beta: managed-agents-2026-04-01' \

29242741 -H "X-Api-Key: $ANTHROPIC_API_KEY"

29252742```

29262743

2927#### Response

2744#### Response (200)

29282745

29292746```json

29302747{

from line 2820

30032820

30042821## Update Agent

30052822

3006**post** `/v1/agents/{agent_id}`

2823**POST** `/v1/agents/{agent_id}`

30072824

30082825Update Agent

30092826

3010### Path Parameters

2827### Path parameters

30112828

30122829- `agent_id: string`

30132830

3014### Header Parameters

2831### Headers

30152832

30162833- `"anthropic-beta": optional array of AnthropicBeta`

30172834

from line 2906

30892906

30902907 - `"mid-conversation-tool-changes-2026-07-01"`

30912908

3092### Body Parameters

2909### Body parameters

30932910

30942911- `description: optional string or null`

30952912

30962913 Description. Omit to preserve; send empty string or null to clear.

30972914

2915 maxLength: 2048

2916

30982917- `mcp_servers: optional array of BetaManagedAgentsURLMCPServerParams or null`

30992918

31002919 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 2922

31032922

31042923 Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.

31052924

2925 minLength: 1, maxLength: 255

2926

31062927 - `type: "url"`

31072928

3108 - `"url"`

3109

31102929 - `url: string`

31112930

31122931 Endpoint URL for the MCP server.

31132932

2933 maxLength: 2048

2934

31142935- `metadata: optional map[string] or null`

31152936

31162937 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 3006

31853006

31863007 - `string`

31873008

3188 - `BetaManagedAgentsModelConfigParams object { id, effort, inference_geo, speed }`

3009 - `BetaManagedAgentsModelConfigParams object`

31893010

31903011 An object that defines additional configuration control over model use

31913012

from line 3034

32133034

32143035 - `"max"`

32153036

3216 - `BetaManagedAgentsEffortLow object { type }`

3037 - `BetaManagedAgentsEffortLow object`

32173038

32183039 Low effort. Favors latency over reasoning depth.

32193040

32203041 - `type: "low"`

32213042

3222 - `"low"`

3223

3224 - `BetaManagedAgentsEffortMedium object { type }`

3043 - `BetaManagedAgentsEffortMedium object`

32253044

32263045 Medium effort. Balances latency and reasoning depth.

32273046

32283047 - `type: "medium"`

32293048

3230 - `"medium"`

3231

3232 - `BetaManagedAgentsEffortHigh object { type }`

3049 - `BetaManagedAgentsEffortHigh object`

32333050

32343051 High effort. Favors reasoning depth.

32353052

32363053 - `type: "high"`

32373054

3238 - `"high"`

3239

3240 - `BetaManagedAgentsEffortXhigh object { type }`

3055 - `BetaManagedAgentsEffortXhigh object`

32413056

32423057 Extra-high effort. Not all models accept this level.

32433058

32443059 - `type: "xhigh"`

32453060

3246 - `"xhigh"`

3247

3248 - `BetaManagedAgentsEffortMax object { type }`

3061 - `BetaManagedAgentsEffortMax object`

32493062

32503063 Maximum effort. Favors reasoning depth over latency.

32513064

32523065 - `type: "max"`

32533066

3254 - `"max"`

3255

32563067 - `inference_geo: optional string or null`

32573068

32583069 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 3086

32753086

32763087 - `string`

32773088

3278 - `BetaManagedAgentsAgentParams object { id, type, version }`

3089 - `BetaManagedAgentsAgentParams object`

32793090

32803091 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version

32813092

from line 3094

32833094

32843095 The `agent` ID.

32853096

3097 minLength: 1, maxLength: 128

3098

32863099 - `type: "agent"`

32873100

3288 - `"agent"`

3289

32903101 - `version: optional number`

32913102

32923103 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.

32933104

3294 - `BetaManagedAgentsMultiagentSelfParams object { type }`

3105 format: int32

3106

3107 - `BetaManagedAgentsMultiagentSelfParams object`

32953108

32963109 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.

32973110

32983111 - `type: "self"`

32993112

3300 - `"self"`

3301

3302 - `BetaManagedAgentsAdvisorParams object { model, type }`

3113 - `BetaManagedAgentsAdvisorParams object`

33033114

33043115 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`.

33053116

from line 3118

33073118

33083119 A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.

33093120

3121 minLength: 1, maxLength: 256

3122

33103123 - `type: "advisor"`

33113124

3312 - `"advisor"`

3313

33143125 - `type: "coordinator"`

33153126

3316 - `"coordinator"`

3317

33183127- `name: optional string`

33193128

33203129 Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.

33213130

3131 maxLength: 256

3132

33223133- `skills: optional array of BetaManagedAgentsSkillParams or null`

33233134

33243135 Skills. Full replacement. Omit to preserve; send empty array or null to clear.

33253136

3326 - `BetaManagedAgentsAnthropicSkillParams object { skill_id, type, version }`

3137 - `BetaManagedAgentsAnthropicSkillParams object`

33273138

33283139 An Anthropic-managed skill.

33293140

from line 3142

33313142

33323143 Identifier of the Anthropic skill (e.g., "xlsx").

33333144

3145 minLength: 1, maxLength: 64

3146

33343147 - `type: "anthropic"`

33353148

3336 - `"anthropic"`

3337

33383149 - `version: optional string or null`

33393150

33403151 Version to pin. Defaults to latest if omitted.

33413152

3342 - `BetaManagedAgentsCustomSkillParams object { skill_id, type, version }`

3153 minLength: 1, maxLength: 64

3154

3155 - `BetaManagedAgentsCustomSkillParams object`

33433156

33443157 A user-created custom skill.

33453158

from line 3160

33473160

33483161 Tagged ID of the custom skill (e.g., "skill_01XJ5...").

33493162

3163 minLength: 1, maxLength: 64

3164

33503165 - `type: "custom"`

33513166

3352 - `"custom"`

3353

33543167 - `version: optional string or null`

33553168

33563169 Version to pin. Defaults to latest if omitted.

33573170

3171 minLength: 1, maxLength: 64

3172

33583173- `system: optional string or null`

33593174

33603175 System prompt. Omit to preserve; send empty string or null to clear.

33613176

3177 maxLength: 100000

3178

33623179- `tools: optional array of BetaManagedAgentsAgentToolset20260401Params or BetaManagedAgentsMCPToolsetParams or BetaManagedAgentsCustomToolParams or null`

33633180

33643181 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.

33653182

3366 - `BetaManagedAgentsAgentToolset20260401Params object { type, configs, default_config }`

3183 - `BetaManagedAgentsAgentToolset20260401Params object`

33673184

33683185 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.

33693186

33703187 - `type: "agent_toolset_20260401"`

33713188

3372 - `"agent_toolset_20260401"`

3373

33743189 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`

33753190

33763191 Per-tool configuration overrides.

33773192

3378 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`

3193 - `BetaManagedAgentsBashToolConfigParams object`

33793194

33803195 Configuration override for the bash tool.

33813196

from line 3198

33833198

33843199 Must be "bash".

33853200

3386 - `"bash"`

3387

33883201 - `enabled: optional boolean or null`

33893202

33903203 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 3206

33933206

33943207 Permission policy for tool execution.

33953208

3396 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3209 - `BetaManagedAgentsAlwaysAllowPolicy object`

33973210

33983211 Tool calls are automatically approved without user confirmation.

33993212

34003213 - `type: "always_allow"`

34013214

3402 - `"always_allow"`

3403

3404 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3215 - `BetaManagedAgentsAlwaysAskPolicy object`

34053216

34063217 Tool calls require user confirmation before execution.

34073218

34083219 - `type: "always_ask"`

34093220

3410 - `"always_ask"`

3411

34123221 - `type: optional "bash"`

34133222

3414 - `"bash"`

3415

3416 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`

3223 - `BetaManagedAgentsEditToolConfigParams object`

34173224

34183225 Configuration override for the edit tool.

34193226

from line 3228

34213228

34223229 Must be "edit".

34233230

3424 - `"edit"`

3425

34263231 - `enabled: optional boolean or null`

34273232

34283233 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 3236

34313236

34323237 Permission policy for tool execution.

34333238

3434 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3239 - `BetaManagedAgentsAlwaysAllowPolicy object`

34353240

34363241 Tool calls are automatically approved without user confirmation.

34373242

3438 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3243 - `BetaManagedAgentsAlwaysAskPolicy object`

34393244

34403245 Tool calls require user confirmation before execution.

34413246

34423247 - `type: optional "edit"`

34433248

3444 - `"edit"`

3445

3446 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`

3249 - `BetaManagedAgentsReadToolConfigParams object`

34473250

34483251 Configuration override for the read tool.

34493252

from line 3254

34513254

34523255 Must be "read".

34533256

3454 - `"read"`

3455

34563257 - `enabled: optional boolean or null`

34573258

34583259 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 3262

34613262

34623263 Permission policy for tool execution.

34633264

3464 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3265 - `BetaManagedAgentsAlwaysAllowPolicy object`

34653266

34663267 Tool calls are automatically approved without user confirmation.

34673268

3468 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3269 - `BetaManagedAgentsAlwaysAskPolicy object`

34693270

34703271 Tool calls require user confirmation before execution.

34713272

34723273 - `type: optional "read"`

34733274

3474 - `"read"`

3475

3476 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`

3275 - `BetaManagedAgentsWriteToolConfigParams object`

34773276

34783277 Configuration override for the write tool.

34793278

from line 3280

34813280

34823281 Must be "write".

34833282

3484 - `"write"`

3485

34863283 - `enabled: optional boolean or null`

34873284

34883285 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 3288

34913288

34923289 Permission policy for tool execution.

34933290

3494 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3291 - `BetaManagedAgentsAlwaysAllowPolicy object`

34953292

34963293 Tool calls are automatically approved without user confirmation.

34973294

3498 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3295 - `BetaManagedAgentsAlwaysAskPolicy object`

34993296

35003297 Tool calls require user confirmation before execution.

35013298

35023299 - `type: optional "write"`

35033300

3504 - `"write"`

3505

3506 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`

3301 - `BetaManagedAgentsGlobToolConfigParams object`

35073302

35083303 Configuration override for the glob tool.

35093304

from line 3306

35113306

35123307 Must be "glob".

35133308

3514 - `"glob"`

3515

35163309 - `enabled: optional boolean or null`

35173310

35183311 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 3314

35213314

35223315 Permission policy for tool execution.

35233316

3524 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3317 - `BetaManagedAgentsAlwaysAllowPolicy object`

35253318

35263319 Tool calls are automatically approved without user confirmation.

35273320

3528 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3321 - `BetaManagedAgentsAlwaysAskPolicy object`

35293322

35303323 Tool calls require user confirmation before execution.

35313324

35323325 - `type: optional "glob"`

35333326

3534 - `"glob"`

3535

3536 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`

3327 - `BetaManagedAgentsGrepToolConfigParams object`

35373328

35383329 Configuration override for the grep tool.

35393330

from line 3332

35413332

35423333 Must be "grep".

35433334

3544 - `"grep"`

3545

35463335 - `enabled: optional boolean or null`

35473336

35483337 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 3340

35513340

35523341 Permission policy for tool execution.

35533342

3554 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3343 - `BetaManagedAgentsAlwaysAllowPolicy object`

35553344

35563345 Tool calls are automatically approved without user confirmation.

35573346

3558 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3347 - `BetaManagedAgentsAlwaysAskPolicy object`

35593348

35603349 Tool calls require user confirmation before execution.

35613350

35623351 - `type: optional "grep"`

35633352

3564 - `"grep"`

3565

3566 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

3353 - `BetaManagedAgentsWebFetchToolConfigParams object`

35673354

35683355 Configuration override for the web_fetch tool.

35693356

from line 3358

35713358

35723359 Must be "web_fetch".

35733360

3574 - `"web_fetch"`

3575

35763361 - `allowed_domains: optional array of string`

35773362

35783363 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 3374

35893374

35903375 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

35913376

3377 format: int32

3378

35923379 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`

35933380

35943381 Permission policy for tool execution.

35953382

3596 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3383 - `BetaManagedAgentsAlwaysAllowPolicy object`

35973384

35983385 Tool calls are automatically approved without user confirmation.

35993386

3600 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3387 - `BetaManagedAgentsAlwaysAskPolicy object`

36013388

36023389 Tool calls require user confirmation before execution.

36033390

36043391 - `type: optional "web_fetch"`

36053392

3606 - `"web_fetch"`

3607

3608 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

3393 - `BetaManagedAgentsWebSearchToolConfigParams object`

36093394

36103395 Configuration override for the web_search tool.

36113396

from line 3398

36133398

36143399 Must be "web_search".

36153400

3616 - `"web_search"`

3617

36183401 - `allowed_domains: optional array of string`

36193402

36203403 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 3414

36313414

36323415 Permission policy for tool execution.

36333416

3634 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3417 - `BetaManagedAgentsAlwaysAllowPolicy object`

36353418

36363419 Tool calls are automatically approved without user confirmation.

36373420

3638 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3421 - `BetaManagedAgentsAlwaysAskPolicy object`

36393422

36403423 Tool calls require user confirmation before execution.

36413424

36423425 - `type: optional "web_search"`

36433426

3644 - `"web_search"`

3645

36463427 - `user_location: optional BetaManagedAgentsUserLocation or null`

36473428

36483429 Approximate user location for search result localization.

from line 3432

36513432

36523433 Location precision. Only "approximate" is supported.

36533434

3654 - `"approximate"`

3655

36563435 - `city: optional string or null`

36573436

36583437 City name.

36593438

3439 minLength: 1, maxLength: 255

3440

36603441 - `country: optional string or null`

36613442

36623443 Two-letter ISO 3166-1 country code, uppercase.

from line 3446

36653446

36663447 Region or state name.

36673448

3449 minLength: 1, maxLength: 255

3450

36683451 - `timezone: optional string or null`

36693452

36703453 IANA timezone identifier, e.g. "America/Los_Angeles".

36713454

3455 minLength: 1, maxLength: 255

3456

36723457 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`

36733458

36743459 Default configuration for all tools in a toolset.

from line 3466

36813466

36823467 Permission policy for tool execution.

36833468

3684 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3469 - `BetaManagedAgentsAlwaysAllowPolicy object`

36853470

36863471 Tool calls are automatically approved without user confirmation.

36873472

3688 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3473 - `BetaManagedAgentsAlwaysAskPolicy object`

36893474

36903475 Tool calls require user confirmation before execution.

36913476

3692 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`

3477 - `BetaManagedAgentsMCPToolsetParams object`

36933478

36943479 Configuration for tools from an MCP server defined in `mcp_servers`.

36953480

from line 3482

36973482

36983483 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.

36993484

3485 minLength: 1, maxLength: 255

3486

37003487 - `type: "mcp_toolset"`

37013488

3702 - `"mcp_toolset"`

3703

37043489 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`

37053490

37063491 Per-tool configuration overrides.

from line 3494

37093494

37103495 Name of the MCP tool to configure. 1-128 characters.

37113496

3497 minLength: 1, maxLength: 128

3498

37123499 - `enabled: optional boolean or null`

37133500

37143501 Whether this tool is enabled. Overrides the `default_config` setting.

from line 3504

37173504

37183505 Permission policy for tool execution.

37193506

3720 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3507 - `BetaManagedAgentsAlwaysAllowPolicy object`

37213508

37223509 Tool calls are automatically approved without user confirmation.

37233510

3724 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3511 - `BetaManagedAgentsAlwaysAskPolicy object`

37253512

37263513 Tool calls require user confirmation before execution.

37273514

from line 3524

37373524

37383525 Permission policy for tool execution.

37393526

3740 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3527 - `BetaManagedAgentsAlwaysAllowPolicy object`

37413528

37423529 Tool calls are automatically approved without user confirmation.

37433530

3744 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3531 - `BetaManagedAgentsAlwaysAskPolicy object`

37453532

37463533 Tool calls require user confirmation before execution.

37473534

3748 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`

3535 - `BetaManagedAgentsCustomToolParams object`

37493536

37503537 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.

37513538

from line 3540

37533540

37543541 Description of what the tool does, shown to the agent to help it decide when to use the tool.

37553542

3543 minLength: 1

3544

37563545 - `input_schema: BetaManagedAgentsCustomToolInputSchema`

37573546

37583547 JSON Schema for custom tool input parameters.

37593548

37603549 - `type: "object"`

37613550

3762 - `"object"`

3763

37643551 - `properties: optional map[unknown] or null`

37653552

37663553 - `required: optional array of string or null`

from line 3556

37693556

37703557 Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.

37713558

3559 minLength: 1, maxLength: 128

3560

37723561 - `type: "custom"`

37733562

3774 - `"custom"`

3775

37763563- `version: optional number`

37773564

37783565 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.

37793566

3567 format: int32

3568

37803569### Returns

37813570

3782- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`

3571- `BetaManagedAgentsAgent object`

37833572

37843573 A Managed Agents `agent`.

37853574

from line 3578

37893578

37903579 A timestamp in RFC 3339 format

37913580

3581 format: date-time

3582

37923583 - `created_at: string`

37933584

37943585 A timestamp in RFC 3339 format

37953586

3587 format: date-time

3588

37963589 - `description: string or null`

37973590

37983591 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 3594

38013594

38023595 - `type: "url"`

38033596

3804 - `"url"`

3805

38063597 - `url: string`

38073598

38083599 - `metadata: map[string]`

from line 3672

38813672

38823673 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

38833674

3884 - `BetaManagedAgentsEffortLow object { type }`

3675 - `BetaManagedAgentsEffortLow object`

38853676

38863677 Low effort. Favors latency over reasoning depth.

38873678

38883679 - `type: "low"`

38893680

3890 - `"low"`

3891

3892 - `BetaManagedAgentsEffortMedium object { type }`

3681 - `BetaManagedAgentsEffortMedium object`

38933682

38943683 Medium effort. Balances latency and reasoning depth.

38953684

38963685 - `type: "medium"`

38973686

3898 - `"medium"`

3899

3900 - `BetaManagedAgentsEffortHigh object { type }`

3687 - `BetaManagedAgentsEffortHigh object`

39013688

39023689 High effort. Favors reasoning depth.

39033690

39043691 - `type: "high"`

39053692

3906 - `"high"`

3907

3908 - `BetaManagedAgentsEffortXhigh object { type }`

3693 - `BetaManagedAgentsEffortXhigh object`

39093694

39103695 Extra-high effort. Not all models accept this level.

39113696

39123697 - `type: "xhigh"`

39133698

3914 - `"xhigh"`

3915

3916 - `BetaManagedAgentsEffortMax object { type }`

3699 - `BetaManagedAgentsEffortMax object`

39173700

39183701 Maximum effort. Favors reasoning depth over latency.

39193702

39203703 - `type: "max"`

39213704

3922 - `"max"`

3923

39243705 - `inference_geo: optional string`

39253706

39263707 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 3722

39413722

39423723 Agents the coordinator may spawn as session threads, each resolved to a specific version.

39433724

3944 - `BetaManagedAgentsAgentReference object { id, type, version }`

3725 - `BetaManagedAgentsAgentReference object`

39453726

39463727 A resolved agent reference with a concrete version.

39473728

from line 3730

39493730

39503731 - `type: "agent"`

39513732

3952 - `"agent"`

3953

39543733 - `version: number`

39553734

3956 - `BetaManagedAgentsAdvisor object { model, type }`

3735 format: int32

3736

3737 - `BetaManagedAgentsAdvisor object`

39573738

39583739 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

39593740

from line 3744

39633744

39643745 - `type: "advisor"`

39653746

3966 - `"advisor"`

3967

39683747 - `type: "coordinator"`

39693748

3970 - `"coordinator"`

3971

39723749 - `name: string`

39733750

39743751 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

39753752

3976 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

3753 - `BetaManagedAgentsAnthropicSkill object`

39773754

39783755 A resolved Anthropic-managed skill.

39793756

from line 3758

39813758

39823759 - `type: "anthropic"`

39833760

3984 - `"anthropic"`

3985

39863761 - `version: string`

39873762

3988 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

3763 - `BetaManagedAgentsCustomSkill object`

39893764

39903765 A resolved user-created custom skill.

39913766

from line 3768

39933768

39943769 - `type: "custom"`

39953770

3996 - `"custom"`

3997

39983771 - `version: string`

39993772

40003773 - `system: string or null`

40013774

40023775 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

40033776

4004 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

3777 - `BetaManagedAgentsAgentToolset20260401 object`

40053778

40063779 - `configs: array of BetaManagedAgentsAgentToolConfig`

40073780

4008 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

3781 - `BetaManagedAgentsBashToolConfig object`

40093782

40103783 Configuration for the bash tool.

40113784

from line 3786

40133786

40143787 - `name: "bash"`

40153788

4016 - `"bash"`

4017

40183789 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

40193790

40203791 Permission policy for tool execution.

40213792

4022 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3793 - `BetaManagedAgentsAlwaysAllowPolicy object`

40233794

40243795 Tool calls are automatically approved without user confirmation.

40253796

40263797 - `type: "always_allow"`

40273798

4028 - `"always_allow"`

4029

4030 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3799 - `BetaManagedAgentsAlwaysAskPolicy object`

40313800

40323801 Tool calls require user confirmation before execution.

40333802

40343803 - `type: "always_ask"`

40353804

4036 - `"always_ask"`

4037

40383805 - `type: "bash"`

40393806

4040 - `"bash"`

4041

4042 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

3807 - `BetaManagedAgentsEditToolConfig object`

40433808

40443809 Configuration for the edit tool.

40453810

from line 3812

40473812

40483813 - `name: "edit"`

40493814

4050 - `"edit"`

4051

40523815 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

40533816

40543817 Permission policy for tool execution.

40553818

4056 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3819 - `BetaManagedAgentsAlwaysAllowPolicy object`

40573820

40583821 Tool calls are automatically approved without user confirmation.

40593822

4060 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3823 - `BetaManagedAgentsAlwaysAskPolicy object`

40613824

40623825 Tool calls require user confirmation before execution.

40633826

40643827 - `type: "edit"`

40653828

4066 - `"edit"`

4067

4068 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

3829 - `BetaManagedAgentsReadToolConfig object`

40693830

40703831 Configuration for the read tool.

40713832

from line 3834

40733834

40743835 - `name: "read"`

40753836

4076 - `"read"`

4077

40783837 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

40793838

40803839 Permission policy for tool execution.

40813840

4082 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3841 - `BetaManagedAgentsAlwaysAllowPolicy object`

40833842

40843843 Tool calls are automatically approved without user confirmation.

40853844

4086 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3845 - `BetaManagedAgentsAlwaysAskPolicy object`

40873846

40883847 Tool calls require user confirmation before execution.

40893848

40903849 - `type: "read"`

40913850

4092 - `"read"`

4093

4094 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

3851 - `BetaManagedAgentsWriteToolConfig object`

40953852

40963853 Configuration for the write tool.

40973854

from line 3856

40993856

41003857 - `name: "write"`

41013858

4102 - `"write"`

4103

41043859 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

41053860

41063861 Permission policy for tool execution.

41073862

4108 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3863 - `BetaManagedAgentsAlwaysAllowPolicy object`

41093864

41103865 Tool calls are automatically approved without user confirmation.

41113866

4112 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3867 - `BetaManagedAgentsAlwaysAskPolicy object`

41133868

41143869 Tool calls require user confirmation before execution.

41153870

41163871 - `type: "write"`

41173872

4118 - `"write"`

4119

4120 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

3873 - `BetaManagedAgentsGlobToolConfig object`

41213874

41223875 Configuration for the glob tool.

41233876

from line 3878

41253878

41263879 - `name: "glob"`

41273880

4128 - `"glob"`

4129

41303881 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

41313882

41323883 Permission policy for tool execution.

41333884

4134 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3885 - `BetaManagedAgentsAlwaysAllowPolicy object`

41353886

41363887 Tool calls are automatically approved without user confirmation.

41373888

4138 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3889 - `BetaManagedAgentsAlwaysAskPolicy object`

41393890

41403891 Tool calls require user confirmation before execution.

41413892

41423893 - `type: "glob"`

41433894

4144 - `"glob"`

4145

4146 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

3895 - `BetaManagedAgentsGrepToolConfig object`

41473896

41483897 Configuration for the grep tool.

41493898

from line 3900

41513900

41523901 - `name: "grep"`

41533902

4154 - `"grep"`

4155

41563903 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

41573904

41583905 Permission policy for tool execution.

41593906

4160 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3907 - `BetaManagedAgentsAlwaysAllowPolicy object`

41613908

41623909 Tool calls are automatically approved without user confirmation.

41633910

4164 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3911 - `BetaManagedAgentsAlwaysAskPolicy object`

41653912

41663913 Tool calls require user confirmation before execution.

41673914

41683915 - `type: "grep"`

41693916

4170 - `"grep"`

4171

4172 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

3917 - `BetaManagedAgentsWebFetchToolConfig object`

41733918

41743919 Configuration for the web_fetch tool.

41753920

from line 3922

41773922

41783923 - `name: "web_fetch"`

41793924

4180 - `"web_fetch"`

4181

41823925 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

41833926

41843927 Permission policy for tool execution.

41853928

4186 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3929 - `BetaManagedAgentsAlwaysAllowPolicy object`

41873930

41883931 Tool calls are automatically approved without user confirmation.

41893932

4190 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3933 - `BetaManagedAgentsAlwaysAskPolicy object`

41913934

41923935 Tool calls require user confirmation before execution.

41933936

41943937 - `type: "web_fetch"`

41953938

4196 - `"web_fetch"`

4197

41983939 - `allowed_domains: optional array of string`

41993940

42003941 - `blocked_domains: optional array of string`

42013942

42023943 - `max_content_tokens: optional number or null`

42033944

4204 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

3945 format: int32

3946

3947 - `BetaManagedAgentsWebSearchToolConfig object`

42053948

42063949 Configuration for the web_search tool.

42073950

from line 3952

42093952

42103953 - `name: "web_search"`

42113954

4212 - `"web_search"`

4213

42143955 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

42153956

42163957 Permission policy for tool execution.

42173958

4218 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

3959 - `BetaManagedAgentsAlwaysAllowPolicy object`

42193960

42203961 Tool calls are automatically approved without user confirmation.

42213962

4222 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

3963 - `BetaManagedAgentsAlwaysAskPolicy object`

42233964

42243965 Tool calls require user confirmation before execution.

42253966

42263967 - `type: "web_search"`

42273968

4228 - `"web_search"`

4229

42303969 - `allowed_domains: optional array of string`

42313970

42323971 - `blocked_domains: optional array of string`

from line 3978

42393978

42403979 Location precision. Only "approximate" is supported.

42413980

4242 - `"approximate"`

4243

42443981 - `city: optional string or null`

42453982

42463983 City name.

42473984

3985 minLength: 1, maxLength: 255

3986

42483987 - `country: optional string or null`

42493988

42503989 Two-letter ISO 3166-1 country code, uppercase.

from line 3992

42533992

42543993 Region or state name.

42553994

3995 minLength: 1, maxLength: 255

3996

42563997 - `timezone: optional string or null`

42573998

42583999 IANA timezone identifier, e.g. "America/Los_Angeles".

42594000

4001 minLength: 1, maxLength: 255

4002

42604003 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

42614004

42624005 Resolved default configuration for agent tools.

from line 4010

42674010

42684011 Permission policy for tool execution.

42694012

4270 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4013 - `BetaManagedAgentsAlwaysAllowPolicy object`

42714014

42724015 Tool calls are automatically approved without user confirmation.

42734016

4274 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4017 - `BetaManagedAgentsAlwaysAskPolicy object`

42754018

42764019 Tool calls require user confirmation before execution.

42774020

42784021 - `type: "agent_toolset_20260401"`

42794022

4280 - `"agent_toolset_20260401"`

4281

4282 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

4023 - `BetaManagedAgentsMCPToolset object`

42834024

42844025 - `configs: array of BetaManagedAgentsMCPToolConfig`

42854026

from line 4032

42914032

42924033 Permission policy for tool execution.

42934034

4294 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4035 - `BetaManagedAgentsAlwaysAllowPolicy object`

42954036

42964037 Tool calls are automatically approved without user confirmation.

42974038

4298 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4039 - `BetaManagedAgentsAlwaysAskPolicy object`

42994040

43004041 Tool calls require user confirmation before execution.

43014042

from line 4050

43094050

43104051 Permission policy for tool execution.

43114052

4312 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4053 - `BetaManagedAgentsAlwaysAllowPolicy object`

43134054

43144055 Tool calls are automatically approved without user confirmation.

43154056

4316 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4057 - `BetaManagedAgentsAlwaysAskPolicy object`

43174058

43184059 Tool calls require user confirmation before execution.

43194060

from line 4062

43214062

43224063 - `type: "mcp_toolset"`

43234064

4324 - `"mcp_toolset"`

4325

4326 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

4065 - `BetaManagedAgentsCustomTool object`

43274066

43284067 A custom tool as returned in API responses.

43294068

from line 4074

43354074

43364075 - `type: "object"`

43374076

4338 - `"object"`

4339

43404077 - `properties: optional map[unknown] or null`

43414078

43424079 - `required: optional array of string or null`

from line 4082

43454082

43464083 - `type: "custom"`

43474084

4348 - `"custom"`

4349

43504085 - `type: "agent"`

43514086

4352 - `"agent"`

4353

43544087 - `updated_at: string`

43554088

43564089 A timestamp in RFC 3339 format

43574090

4091 format: date-time

4092

43584093 - `version: number`

43594094

43604095 The agent's current version. Starts at 1 and increments when the agent is modified.

43614096

4097 format: int32

4098

43624099### Example

43634100

4364```http

4101```bash

43654102curl https://api.anthropic.com/v1/agents/$AGENT_ID \

43664103 -H 'Content-Type: application/json' \

43674104 -H 'anthropic-version: 2023-06-01' \

from line 4111

43744111 }'

43754112```

43764113

4377#### Response

4114#### Response (200)

43784115

43794116```json

43804117{

from line 4190

44534190

44544191## Archive Agent

44554192

4456**post** `/v1/agents/{agent_id}/archive`

4193**POST** `/v1/agents/{agent_id}/archive`

44574194

44584195Archive Agent

44594196

4460### Path Parameters

4197### Path parameters

44614198

44624199- `agent_id: string`

44634200

4464### Header Parameters

4201### Headers

44654202

44664203- `"anthropic-beta": optional array of AnthropicBeta`

44674204

from line 4278

45414278

45424279### Returns

45434280

4544- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`

4281- `BetaManagedAgentsAgent object`

45454282

45464283 A Managed Agents `agent`.

45474284

from line 4288

45514288

45524289 A timestamp in RFC 3339 format

45534290

4291 format: date-time

4292

45544293 - `created_at: string`

45554294

45564295 A timestamp in RFC 3339 format

45574296

4297 format: date-time

4298

45584299 - `description: string or null`

45594300

45604301 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 4304

45634304

45644305 - `type: "url"`

45654306

4566 - `"url"`

4567

45684307 - `url: string`

45694308

45704309 - `metadata: map[string]`

from line 4382

46434382

46444383 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

46454384

4646 - `BetaManagedAgentsEffortLow object { type }`

4385 - `BetaManagedAgentsEffortLow object`

46474386

46484387 Low effort. Favors latency over reasoning depth.

46494388

46504389 - `type: "low"`

46514390

4652 - `"low"`

4653

4654 - `BetaManagedAgentsEffortMedium object { type }`

4391 - `BetaManagedAgentsEffortMedium object`

46554392

46564393 Medium effort. Balances latency and reasoning depth.

46574394

46584395 - `type: "medium"`

46594396

4660 - `"medium"`

4661

4662 - `BetaManagedAgentsEffortHigh object { type }`

4397 - `BetaManagedAgentsEffortHigh object`

46634398

46644399 High effort. Favors reasoning depth.

46654400

46664401 - `type: "high"`

46674402

4668 - `"high"`

4669

4670 - `BetaManagedAgentsEffortXhigh object { type }`

4403 - `BetaManagedAgentsEffortXhigh object`

46714404

46724405 Extra-high effort. Not all models accept this level.

46734406

46744407 - `type: "xhigh"`

46754408

4676 - `"xhigh"`

4677

4678 - `BetaManagedAgentsEffortMax object { type }`

4409 - `BetaManagedAgentsEffortMax object`

46794410

46804411 Maximum effort. Favors reasoning depth over latency.

46814412

46824413 - `type: "max"`

46834414

4684 - `"max"`

4685

46864415 - `inference_geo: optional string`

46874416

46884417 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 4432

47034432

47044433 Agents the coordinator may spawn as session threads, each resolved to a specific version.

47054434

4706 - `BetaManagedAgentsAgentReference object { id, type, version }`

4435 - `BetaManagedAgentsAgentReference object`

47074436

47084437 A resolved agent reference with a concrete version.

47094438

from line 4440

47114440

47124441 - `type: "agent"`

47134442

4714 - `"agent"`

4715

47164443 - `version: number`

47174444

4718 - `BetaManagedAgentsAdvisor object { model, type }`

4445 format: int32

4446

4447 - `BetaManagedAgentsAdvisor object`

47194448

47204449 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

47214450

from line 4454

47254454

47264455 - `type: "advisor"`

47274456

4728 - `"advisor"`

4729

47304457 - `type: "coordinator"`

47314458

4732 - `"coordinator"`

4733

47344459 - `name: string`

47354460

47364461 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

47374462

4738 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

4463 - `BetaManagedAgentsAnthropicSkill object`

47394464

47404465 A resolved Anthropic-managed skill.

47414466

from line 4468

47434468

47444469 - `type: "anthropic"`

47454470

4746 - `"anthropic"`

4747

47484471 - `version: string`

47494472

4750 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

4473 - `BetaManagedAgentsCustomSkill object`

47514474

47524475 A resolved user-created custom skill.

47534476

from line 4478

47554478

47564479 - `type: "custom"`

47574480

4758 - `"custom"`

4759

47604481 - `version: string`

47614482

47624483 - `system: string or null`

47634484

47644485 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

47654486

4766 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

4487 - `BetaManagedAgentsAgentToolset20260401 object`

47674488

47684489 - `configs: array of BetaManagedAgentsAgentToolConfig`

47694490

4770 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

4491 - `BetaManagedAgentsBashToolConfig object`

47714492

47724493 Configuration for the bash tool.

47734494

from line 4496

47754496

47764497 - `name: "bash"`

47774498

4778 - `"bash"`

4779

47804499 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

47814500

47824501 Permission policy for tool execution.

47834502

4784 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4503 - `BetaManagedAgentsAlwaysAllowPolicy object`

47854504

47864505 Tool calls are automatically approved without user confirmation.

47874506

47884507 - `type: "always_allow"`

47894508

4790 - `"always_allow"`

4791

4792 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4509 - `BetaManagedAgentsAlwaysAskPolicy object`

47934510

47944511 Tool calls require user confirmation before execution.

47954512

47964513 - `type: "always_ask"`

47974514

4798 - `"always_ask"`

4799

48004515 - `type: "bash"`

48014516

4802 - `"bash"`

4803

4804 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

4517 - `BetaManagedAgentsEditToolConfig object`

48054518

48064519 Configuration for the edit tool.

48074520

from line 4522

48094522

48104523 - `name: "edit"`

48114524

4812 - `"edit"`

4813

48144525 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

48154526

48164527 Permission policy for tool execution.

48174528

4818 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4529 - `BetaManagedAgentsAlwaysAllowPolicy object`

48194530

48204531 Tool calls are automatically approved without user confirmation.

48214532

4822 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4533 - `BetaManagedAgentsAlwaysAskPolicy object`

48234534

48244535 Tool calls require user confirmation before execution.

48254536

48264537 - `type: "edit"`

48274538

4828 - `"edit"`

4829

4830 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

4539 - `BetaManagedAgentsReadToolConfig object`

48314540

48324541 Configuration for the read tool.

48334542

from line 4544

48354544

48364545 - `name: "read"`

48374546

4838 - `"read"`

4839

48404547 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

48414548

48424549 Permission policy for tool execution.

48434550

4844 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4551 - `BetaManagedAgentsAlwaysAllowPolicy object`

48454552

48464553 Tool calls are automatically approved without user confirmation.

48474554

4848 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4555 - `BetaManagedAgentsAlwaysAskPolicy object`

48494556

48504557 Tool calls require user confirmation before execution.

48514558

48524559 - `type: "read"`

48534560

4854 - `"read"`

4855

4856 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

4561 - `BetaManagedAgentsWriteToolConfig object`

48574562

48584563 Configuration for the write tool.

48594564

from line 4566

48614566

48624567 - `name: "write"`

48634568

4864 - `"write"`

4865

48664569 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

48674570

48684571 Permission policy for tool execution.

48694572

4870 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4573 - `BetaManagedAgentsAlwaysAllowPolicy object`

48714574

48724575 Tool calls are automatically approved without user confirmation.

48734576

4874 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4577 - `BetaManagedAgentsAlwaysAskPolicy object`

48754578

48764579 Tool calls require user confirmation before execution.

48774580

48784581 - `type: "write"`

48794582

4880 - `"write"`

4881

4882 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

4583 - `BetaManagedAgentsGlobToolConfig object`

48834584

48844585 Configuration for the glob tool.

48854586

from line 4588

48874588

48884589 - `name: "glob"`

48894590

4890 - `"glob"`

4891

48924591 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

48934592

48944593 Permission policy for tool execution.

48954594

4896 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4595 - `BetaManagedAgentsAlwaysAllowPolicy object`

48974596

48984597 Tool calls are automatically approved without user confirmation.

48994598

4900 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4599 - `BetaManagedAgentsAlwaysAskPolicy object`

49014600

49024601 Tool calls require user confirmation before execution.

49034602

49044603 - `type: "glob"`

49054604

4906 - `"glob"`

4907

4908 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

4605 - `BetaManagedAgentsGrepToolConfig object`

49094606

49104607 Configuration for the grep tool.

49114608

from line 4610

49134610

49144611 - `name: "grep"`

49154612

4916 - `"grep"`

4917

49184613 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

49194614

49204615 Permission policy for tool execution.

49214616

4922 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4617 - `BetaManagedAgentsAlwaysAllowPolicy object`

49234618

49244619 Tool calls are automatically approved without user confirmation.

49254620

4926 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4621 - `BetaManagedAgentsAlwaysAskPolicy object`

49274622

49284623 Tool calls require user confirmation before execution.

49294624

49304625 - `type: "grep"`

49314626

4932 - `"grep"`

4933

4934 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

4627 - `BetaManagedAgentsWebFetchToolConfig object`

49354628

49364629 Configuration for the web_fetch tool.

49374630

from line 4632

49394632

49404633 - `name: "web_fetch"`

49414634

4942 - `"web_fetch"`

4943

49444635 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

49454636

49464637 Permission policy for tool execution.

49474638

4948 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4639 - `BetaManagedAgentsAlwaysAllowPolicy object`

49494640

49504641 Tool calls are automatically approved without user confirmation.

49514642

4952 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4643 - `BetaManagedAgentsAlwaysAskPolicy object`

49534644

49544645 Tool calls require user confirmation before execution.

49554646

49564647 - `type: "web_fetch"`

49574648

4958 - `"web_fetch"`

4959

49604649 - `allowed_domains: optional array of string`

49614650

49624651 - `blocked_domains: optional array of string`

49634652

49644653 - `max_content_tokens: optional number or null`

49654654

4966 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

4655 format: int32

4656

4657 - `BetaManagedAgentsWebSearchToolConfig object`

49674658

49684659 Configuration for the web_search tool.

49694660

from line 4662

49714662

49724663 - `name: "web_search"`

49734664

4974 - `"web_search"`

4975

49764665 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

49774666

49784667 Permission policy for tool execution.

49794668

4980 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4669 - `BetaManagedAgentsAlwaysAllowPolicy object`

49814670

49824671 Tool calls are automatically approved without user confirmation.

49834672

4984 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4673 - `BetaManagedAgentsAlwaysAskPolicy object`

49854674

49864675 Tool calls require user confirmation before execution.

49874676

49884677 - `type: "web_search"`

49894678

4990 - `"web_search"`

4991

49924679 - `allowed_domains: optional array of string`

49934680

49944681 - `blocked_domains: optional array of string`

from line 4688

50014688

50024689 Location precision. Only "approximate" is supported.

50034690

5004 - `"approximate"`

5005

50064691 - `city: optional string or null`

50074692

50084693 City name.

50094694

4695 minLength: 1, maxLength: 255

4696

50104697 - `country: optional string or null`

50114698

50124699 Two-letter ISO 3166-1 country code, uppercase.

from line 4702

50154702

50164703 Region or state name.

50174704

4705 minLength: 1, maxLength: 255

4706

50184707 - `timezone: optional string or null`

50194708

50204709 IANA timezone identifier, e.g. "America/Los_Angeles".

50214710

4711 minLength: 1, maxLength: 255

4712

50224713 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

50234714

50244715 Resolved default configuration for agent tools.

from line 4720

50294720

50304721 Permission policy for tool execution.

50314722

5032 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4723 - `BetaManagedAgentsAlwaysAllowPolicy object`

50334724

50344725 Tool calls are automatically approved without user confirmation.

50354726

5036 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4727 - `BetaManagedAgentsAlwaysAskPolicy object`

50374728

50384729 Tool calls require user confirmation before execution.

50394730

50404731 - `type: "agent_toolset_20260401"`

50414732

5042 - `"agent_toolset_20260401"`

5043

5044 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

4733 - `BetaManagedAgentsMCPToolset object`

50454734

50464735 - `configs: array of BetaManagedAgentsMCPToolConfig`

50474736

from line 4742

50534742

50544743 Permission policy for tool execution.

50554744

5056 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4745 - `BetaManagedAgentsAlwaysAllowPolicy object`

50574746

50584747 Tool calls are automatically approved without user confirmation.

50594748

5060 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4749 - `BetaManagedAgentsAlwaysAskPolicy object`

50614750

50624751 Tool calls require user confirmation before execution.

50634752

from line 4760

50714760

50724761 Permission policy for tool execution.

50734762

5074 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

4763 - `BetaManagedAgentsAlwaysAllowPolicy object`

50754764

50764765 Tool calls are automatically approved without user confirmation.

50774766

5078 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

4767 - `BetaManagedAgentsAlwaysAskPolicy object`

50794768

50804769 Tool calls require user confirmation before execution.

50814770

from line 4772

50834772

50844773 - `type: "mcp_toolset"`

50854774

5086 - `"mcp_toolset"`

5087

5088 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

4775 - `BetaManagedAgentsCustomTool object`

50894776

50904777 A custom tool as returned in API responses.

50914778

from line 4784

50974784

50984785 - `type: "object"`

50994786

5100 - `"object"`

5101

51024787 - `properties: optional map[unknown] or null`

51034788

51044789 - `required: optional array of string or null`

from line 4792

51074792

51084793 - `type: "custom"`

51094794

5110 - `"custom"`

5111

51124795 - `type: "agent"`

51134796

5114 - `"agent"`

5115

51164797 - `updated_at: string`

51174798

51184799 A timestamp in RFC 3339 format

51194800

4801 format: date-time

4802

51204803 - `version: number`

51214804

51224805 The agent's current version. Starts at 1 and increments when the agent is modified.

51234806

4807 format: int32

4808

51244809### Example

51254810

5126```http

4811```bash

51274812curl https://api.anthropic.com/v1/agents/$AGENT_ID/archive \

51284813 -X POST \

51294814 -H 'anthropic-version: 2023-06-01' \

from line 4816

51314816 -H "X-Api-Key: $ANTHROPIC_API_KEY"

51324817```

51334818

5134#### Response

4819#### Response (200)

51354820

51364821```json

51374822{

from line 4893

52084893}

52094894```

52104895

5211## Domain Types

4896## Domain types

52124897

52134898### Beta Managed Agents Advisor

52144899

5215- `BetaManagedAgentsAdvisor object { model, type }`

4900- `BetaManagedAgentsAdvisor object`

52164901

52174902 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

52184903

from line 4907

52224907

52234908 - `type: "advisor"`

52244909

5225 - `"advisor"`

5226

52274910### Beta Managed Agents Agent

52284911

5229- `BetaManagedAgentsAgent object { id, archived_at, created_at, 12 more }`

4912- `BetaManagedAgentsAgent object`

52304913

52314914 A Managed Agents `agent`.

52324915

from line 4919

52364919

52374920 A timestamp in RFC 3339 format

52384921

4922 format: date-time

4923

52394924 - `created_at: string`

52404925

52414926 A timestamp in RFC 3339 format

52424927

4928 format: date-time

4929

52434930 - `description: string or null`

52444931

52454932 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 4935

52484935

52494936 - `type: "url"`

52504937

5251 - `"url"`

5252

52534938 - `url: string`

52544939

52554940 - `metadata: map[string]`

from line 5013

53285013

53295014 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

53305015

5331 - `BetaManagedAgentsEffortLow object { type }`

5016 - `BetaManagedAgentsEffortLow object`

53325017

53335018 Low effort. Favors latency over reasoning depth.

53345019

53355020 - `type: "low"`

53365021

5337 - `"low"`

5338

5339 - `BetaManagedAgentsEffortMedium object { type }`

5022 - `BetaManagedAgentsEffortMedium object`

53405023

53415024 Medium effort. Balances latency and reasoning depth.

53425025

53435026 - `type: "medium"`

53445027

5345 - `"medium"`

5346

5347 - `BetaManagedAgentsEffortHigh object { type }`

5028 - `BetaManagedAgentsEffortHigh object`

53485029

53495030 High effort. Favors reasoning depth.

53505031

53515032 - `type: "high"`

53525033

5353 - `"high"`

5354

5355 - `BetaManagedAgentsEffortXhigh object { type }`

5034 - `BetaManagedAgentsEffortXhigh object`

53565035

53575036 Extra-high effort. Not all models accept this level.

53585037

53595038 - `type: "xhigh"`

53605039

5361 - `"xhigh"`

5362

5363 - `BetaManagedAgentsEffortMax object { type }`

5040 - `BetaManagedAgentsEffortMax object`

53645041

53655042 Maximum effort. Favors reasoning depth over latency.

53665043

53675044 - `type: "max"`

53685045

5369 - `"max"`

5370

53715046 - `inference_geo: optional string`

53725047

53735048 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 5063

53885063

53895064 Agents the coordinator may spawn as session threads, each resolved to a specific version.

53905065

5391 - `BetaManagedAgentsAgentReference object { id, type, version }`

5066 - `BetaManagedAgentsAgentReference object`

53925067

53935068 A resolved agent reference with a concrete version.

53945069

from line 5071

53965071

53975072 - `type: "agent"`

53985073

5399 - `"agent"`

5400

54015074 - `version: number`

54025075

5403 - `BetaManagedAgentsAdvisor object { model, type }`

5076 format: int32

5077

5078 - `BetaManagedAgentsAdvisor object`

54045079

54055080 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

54065081

from line 5085

54105085

54115086 - `type: "advisor"`

54125087

5413 - `"advisor"`

5414

54155088 - `type: "coordinator"`

54165089

5417 - `"coordinator"`

5418

54195090 - `name: string`

54205091

54215092 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

54225093

5423 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

5094 - `BetaManagedAgentsAnthropicSkill object`

54245095

54255096 A resolved Anthropic-managed skill.

54265097

from line 5099

54285099

54295100 - `type: "anthropic"`

54305101

5431 - `"anthropic"`

5432

54335102 - `version: string`

54345103

5435 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

5104 - `BetaManagedAgentsCustomSkill object`

54365105

54375106 A resolved user-created custom skill.

54385107

from line 5109

54405109

54415110 - `type: "custom"`

54425111

5443 - `"custom"`

5444

54455112 - `version: string`

54465113

54475114 - `system: string or null`

54485115

54495116 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

54505117

5451 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

5118 - `BetaManagedAgentsAgentToolset20260401 object`

54525119

54535120 - `configs: array of BetaManagedAgentsAgentToolConfig`

54545121

5455 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

5122 - `BetaManagedAgentsBashToolConfig object`

54565123

54575124 Configuration for the bash tool.

54585125

from line 5127

54605127

54615128 - `name: "bash"`

54625129

5463 - `"bash"`

5464

54655130 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

54665131

54675132 Permission policy for tool execution.

54685133

5469 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5134 - `BetaManagedAgentsAlwaysAllowPolicy object`

54705135

54715136 Tool calls are automatically approved without user confirmation.

54725137

54735138 - `type: "always_allow"`

54745139

5475 - `"always_allow"`

5476

5477 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5140 - `BetaManagedAgentsAlwaysAskPolicy object`

54785141

54795142 Tool calls require user confirmation before execution.

54805143

54815144 - `type: "always_ask"`

54825145

5483 - `"always_ask"`

5484

54855146 - `type: "bash"`

54865147

5487 - `"bash"`

5488

5489 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

5148 - `BetaManagedAgentsEditToolConfig object`

54905149

54915150 Configuration for the edit tool.

54925151

from line 5153

54945153

54955154 - `name: "edit"`

54965155

5497 - `"edit"`

5498

54995156 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

55005157

55015158 Permission policy for tool execution.

55025159

5503 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5160 - `BetaManagedAgentsAlwaysAllowPolicy object`

55045161

55055162 Tool calls are automatically approved without user confirmation.

55065163

5507 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5164 - `BetaManagedAgentsAlwaysAskPolicy object`

55085165

55095166 Tool calls require user confirmation before execution.

55105167

55115168 - `type: "edit"`

55125169

5513 - `"edit"`

5514

5515 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

5170 - `BetaManagedAgentsReadToolConfig object`

55165171

55175172 Configuration for the read tool.

55185173

from line 5175

55205175

55215176 - `name: "read"`

55225177

5523 - `"read"`

5524

55255178 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

55265179

55275180 Permission policy for tool execution.

55285181

5529 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5182 - `BetaManagedAgentsAlwaysAllowPolicy object`

55305183

55315184 Tool calls are automatically approved without user confirmation.

55325185

5533 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5186 - `BetaManagedAgentsAlwaysAskPolicy object`

55345187

55355188 Tool calls require user confirmation before execution.

55365189

55375190 - `type: "read"`

55385191

5539 - `"read"`

5540

5541 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

5192 - `BetaManagedAgentsWriteToolConfig object`

55425193

55435194 Configuration for the write tool.

55445195

from line 5197

55465197

55475198 - `name: "write"`

55485199

5549 - `"write"`

5550

55515200 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

55525201

55535202 Permission policy for tool execution.

55545203

5555 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5204 - `BetaManagedAgentsAlwaysAllowPolicy object`

55565205

55575206 Tool calls are automatically approved without user confirmation.

55585207

5559 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5208 - `BetaManagedAgentsAlwaysAskPolicy object`

55605209

55615210 Tool calls require user confirmation before execution.

55625211

55635212 - `type: "write"`

55645213

5565 - `"write"`

5566

5567 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

5214 - `BetaManagedAgentsGlobToolConfig object`

55685215

55695216 Configuration for the glob tool.

55705217

from line 5219

55725219

55735220 - `name: "glob"`

55745221

5575 - `"glob"`

5576

55775222 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

55785223

55795224 Permission policy for tool execution.

55805225

5581 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5226 - `BetaManagedAgentsAlwaysAllowPolicy object`

55825227

55835228 Tool calls are automatically approved without user confirmation.

55845229

5585 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5230 - `BetaManagedAgentsAlwaysAskPolicy object`

55865231

55875232 Tool calls require user confirmation before execution.

55885233

55895234 - `type: "glob"`

55905235

5591 - `"glob"`

5592

5593 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

5236 - `BetaManagedAgentsGrepToolConfig object`

55945237

55955238 Configuration for the grep tool.

55965239

from line 5241

55985241

55995242 - `name: "grep"`

56005243

5601 - `"grep"`

5602

56035244 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

56045245

56055246 Permission policy for tool execution.

56065247

5607 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5248 - `BetaManagedAgentsAlwaysAllowPolicy object`

56085249

56095250 Tool calls are automatically approved without user confirmation.

56105251

5611 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5252 - `BetaManagedAgentsAlwaysAskPolicy object`

56125253

56135254 Tool calls require user confirmation before execution.

56145255

56155256 - `type: "grep"`

56165257

5617 - `"grep"`

5618

5619 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

5258 - `BetaManagedAgentsWebFetchToolConfig object`

56205259

56215260 Configuration for the web_fetch tool.

56225261

from line 5263

56245263

56255264 - `name: "web_fetch"`

56265265

5627 - `"web_fetch"`

5628

56295266 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

56305267

56315268 Permission policy for tool execution.

56325269

5633 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5270 - `BetaManagedAgentsAlwaysAllowPolicy object`

56345271

56355272 Tool calls are automatically approved without user confirmation.

56365273

5637 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5274 - `BetaManagedAgentsAlwaysAskPolicy object`

56385275

56395276 Tool calls require user confirmation before execution.

56405277

56415278 - `type: "web_fetch"`

56425279

5643 - `"web_fetch"`

5644

56455280 - `allowed_domains: optional array of string`

56465281

56475282 - `blocked_domains: optional array of string`

56485283

56495284 - `max_content_tokens: optional number or null`

56505285

5651 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

5286 format: int32

5287

5288 - `BetaManagedAgentsWebSearchToolConfig object`

56525289

56535290 Configuration for the web_search tool.

56545291

from line 5293

56565293

56575294 - `name: "web_search"`

56585295

5659 - `"web_search"`

5660

56615296 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

56625297

56635298 Permission policy for tool execution.

56645299

5665 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5300 - `BetaManagedAgentsAlwaysAllowPolicy object`

56665301

56675302 Tool calls are automatically approved without user confirmation.

56685303

5669 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5304 - `BetaManagedAgentsAlwaysAskPolicy object`

56705305

56715306 Tool calls require user confirmation before execution.

56725307

56735308 - `type: "web_search"`

56745309

5675 - `"web_search"`

5676

56775310 - `allowed_domains: optional array of string`

56785311

56795312 - `blocked_domains: optional array of string`

from line 5319

56865319

56875320 Location precision. Only "approximate" is supported.

56885321

5689 - `"approximate"`

5690

56915322 - `city: optional string or null`

56925323

56935324 City name.

56945325

5326 minLength: 1, maxLength: 255

5327

56955328 - `country: optional string or null`

56965329

56975330 Two-letter ISO 3166-1 country code, uppercase.

from line 5333

57005333

57015334 Region or state name.

57025335

5336 minLength: 1, maxLength: 255

5337

57035338 - `timezone: optional string or null`

57045339

57055340 IANA timezone identifier, e.g. "America/Los_Angeles".

57065341

5342 minLength: 1, maxLength: 255

5343

57075344 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

57085345

57095346 Resolved default configuration for agent tools.

from line 5351

57145351

57155352 Permission policy for tool execution.

57165353

5717 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5354 - `BetaManagedAgentsAlwaysAllowPolicy object`

57185355

57195356 Tool calls are automatically approved without user confirmation.

57205357

5721 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5358 - `BetaManagedAgentsAlwaysAskPolicy object`

57225359

57235360 Tool calls require user confirmation before execution.

57245361

57255362 - `type: "agent_toolset_20260401"`

57265363

5727 - `"agent_toolset_20260401"`

5728

5729 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

5364 - `BetaManagedAgentsMCPToolset object`

57305365

57315366 - `configs: array of BetaManagedAgentsMCPToolConfig`

57325367

from line 5373

57385373

57395374 Permission policy for tool execution.

57405375

5741 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5376 - `BetaManagedAgentsAlwaysAllowPolicy object`

57425377

57435378 Tool calls are automatically approved without user confirmation.

57445379

5745 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5380 - `BetaManagedAgentsAlwaysAskPolicy object`

57465381

57475382 Tool calls require user confirmation before execution.

57485383

from line 5391

57565391

57575392 Permission policy for tool execution.

57585393

5759 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5394 - `BetaManagedAgentsAlwaysAllowPolicy object`

57605395

57615396 Tool calls are automatically approved without user confirmation.

57625397

5763 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5398 - `BetaManagedAgentsAlwaysAskPolicy object`

57645399

57655400 Tool calls require user confirmation before execution.

57665401

from line 5403

57685403

57695404 - `type: "mcp_toolset"`

57705405

5771 - `"mcp_toolset"`

5772

5773 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

5406 - `BetaManagedAgentsCustomTool object`

57745407

57755408 A custom tool as returned in API responses.

57765409

from line 5415

57825415

57835416 - `type: "object"`

57845417

5785 - `"object"`

5786

57875418 - `properties: optional map[unknown] or null`

57885419

57895420 - `required: optional array of string or null`

from line 5423

57925423

57935424 - `type: "custom"`

57945425

5795 - `"custom"`

5796

57975426 - `type: "agent"`

57985427

5799 - `"agent"`

5800

58015428 - `updated_at: string`

58025429

58035430 A timestamp in RFC 3339 format

58045431

5432 format: date-time

5433

58055434 - `version: number`

58065435

58075436 The agent's current version. Starts at 1 and increments when the agent is modified.

58085437

5438 format: int32

5439

58095440### Beta Managed Agents Agent Reference

58105441

5811- `BetaManagedAgentsAgentReference object { id, type, version }`

5442- `BetaManagedAgentsAgentReference object`

58125443

58135444 A resolved agent reference with a concrete version.

58145445

from line 5447

58165447

58175448 - `type: "agent"`

58185449

5819 - `"agent"`

5820

58215450 - `version: number`

58225451

5452 format: int32

5453

58235454### Beta Managed Agents Agent Tool Config

58245455

58255456- `BetaManagedAgentsAgentToolConfig = BetaManagedAgentsBashToolConfig or BetaManagedAgentsEditToolConfig or BetaManagedAgentsReadToolConfig or 5 more`

58265457

58275458 Configuration for a specific agent tool.

58285459

5829 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

5460 - `BetaManagedAgentsBashToolConfig object`

58305461

58315462 Configuration for the bash tool.

58325463

from line 5465

58345465

58355466 - `name: "bash"`

58365467

5837 - `"bash"`

5838

58395468 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

58405469

58415470 Permission policy for tool execution.

58425471

5843 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5472 - `BetaManagedAgentsAlwaysAllowPolicy object`

58445473

58455474 Tool calls are automatically approved without user confirmation.

58465475

58475476 - `type: "always_allow"`

58485477

5849 - `"always_allow"`

5850

5851 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5478 - `BetaManagedAgentsAlwaysAskPolicy object`

58525479

58535480 Tool calls require user confirmation before execution.

58545481

58555482 - `type: "always_ask"`

58565483

5857 - `"always_ask"`

5858

58595484 - `type: "bash"`

58605485

5861 - `"bash"`

5862

5863 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

5486 - `BetaManagedAgentsEditToolConfig object`

58645487

58655488 Configuration for the edit tool.

58665489

from line 5491

58685491

58695492 - `name: "edit"`

58705493

5871 - `"edit"`

5872

58735494 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

58745495

58755496 Permission policy for tool execution.

58765497

5877 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5498 - `BetaManagedAgentsAlwaysAllowPolicy object`

58785499

58795500 Tool calls are automatically approved without user confirmation.

58805501

5881 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5502 - `BetaManagedAgentsAlwaysAskPolicy object`

58825503

58835504 Tool calls require user confirmation before execution.

58845505

58855506 - `type: "edit"`

58865507

5887 - `"edit"`

5888

5889 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

5508 - `BetaManagedAgentsReadToolConfig object`

58905509

58915510 Configuration for the read tool.

58925511

from line 5513

58945513

58955514 - `name: "read"`

58965515

5897 - `"read"`

5898

58995516 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

59005517

59015518 Permission policy for tool execution.

59025519

5903 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5520 - `BetaManagedAgentsAlwaysAllowPolicy object`

59045521

59055522 Tool calls are automatically approved without user confirmation.

59065523

5907 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5524 - `BetaManagedAgentsAlwaysAskPolicy object`

59085525

59095526 Tool calls require user confirmation before execution.

59105527

59115528 - `type: "read"`

59125529

5913 - `"read"`

5914

5915 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

5530 - `BetaManagedAgentsWriteToolConfig object`

59165531

59175532 Configuration for the write tool.

59185533

from line 5535

59205535

59215536 - `name: "write"`

59225537

5923 - `"write"`

5924

59255538 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

59265539

59275540 Permission policy for tool execution.

59285541

5929 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5542 - `BetaManagedAgentsAlwaysAllowPolicy object`

59305543

59315544 Tool calls are automatically approved without user confirmation.

59325545

5933 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5546 - `BetaManagedAgentsAlwaysAskPolicy object`

59345547

59355548 Tool calls require user confirmation before execution.

59365549

59375550 - `type: "write"`

59385551

5939 - `"write"`

5940

5941 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

5552 - `BetaManagedAgentsGlobToolConfig object`

59425553

59435554 Configuration for the glob tool.

59445555

from line 5557

59465557

59475558 - `name: "glob"`

59485559

5949 - `"glob"`

5950

59515560 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

59525561

59535562 Permission policy for tool execution.

59545563

5955 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5564 - `BetaManagedAgentsAlwaysAllowPolicy object`

59565565

59575566 Tool calls are automatically approved without user confirmation.

59585567

5959 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5568 - `BetaManagedAgentsAlwaysAskPolicy object`

59605569

59615570 Tool calls require user confirmation before execution.

59625571

59635572 - `type: "glob"`

59645573

5965 - `"glob"`

5966

5967 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

5574 - `BetaManagedAgentsGrepToolConfig object`

59685575

59695576 Configuration for the grep tool.

59705577

from line 5579

59725579

59735580 - `name: "grep"`

59745581

5975 - `"grep"`

5976

59775582 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

59785583

59795584 Permission policy for tool execution.

59805585

5981 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5586 - `BetaManagedAgentsAlwaysAllowPolicy object`

59825587

59835588 Tool calls are automatically approved without user confirmation.

59845589

5985 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5590 - `BetaManagedAgentsAlwaysAskPolicy object`

59865591

59875592 Tool calls require user confirmation before execution.

59885593

59895594 - `type: "grep"`

59905595

5991 - `"grep"`

5992

5993 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

5596 - `BetaManagedAgentsWebFetchToolConfig object`

59945597

59955598 Configuration for the web_fetch tool.

59965599

from line 5601

59985601

59995602 - `name: "web_fetch"`

60005603

6001 - `"web_fetch"`

6002

60035604 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

60045605

60055606 Permission policy for tool execution.

60065607

6007 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5608 - `BetaManagedAgentsAlwaysAllowPolicy object`

60085609

60095610 Tool calls are automatically approved without user confirmation.

60105611

6011 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5612 - `BetaManagedAgentsAlwaysAskPolicy object`

60125613

60135614 Tool calls require user confirmation before execution.

60145615

60155616 - `type: "web_fetch"`

60165617

6017 - `"web_fetch"`

6018

60195618 - `allowed_domains: optional array of string`

60205619

60215620 - `blocked_domains: optional array of string`

60225621

60235622 - `max_content_tokens: optional number or null`

60245623

6025 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

5624 format: int32

5625

5626 - `BetaManagedAgentsWebSearchToolConfig object`

60265627

60275628 Configuration for the web_search tool.

60285629

from line 5631

60305631

60315632 - `name: "web_search"`

60325633

6033 - `"web_search"`

6034

60355634 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

60365635

60375636 Permission policy for tool execution.

60385637

6039 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5638 - `BetaManagedAgentsAlwaysAllowPolicy object`

60405639

60415640 Tool calls are automatically approved without user confirmation.

60425641

6043 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5642 - `BetaManagedAgentsAlwaysAskPolicy object`

60445643

60455644 Tool calls require user confirmation before execution.

60465645

60475646 - `type: "web_search"`

60485647

6049 - `"web_search"`

6050

60515648 - `allowed_domains: optional array of string`

60525649

60535650 - `blocked_domains: optional array of string`

from line 5657

60605657

60615658 Location precision. Only "approximate" is supported.

60625659

6063 - `"approximate"`

6064

60655660 - `city: optional string or null`

60665661

60675662 City name.

60685663

5664 minLength: 1, maxLength: 255

5665

60695666 - `country: optional string or null`

60705667

60715668 Two-letter ISO 3166-1 country code, uppercase.

from line 5671

60745671

60755672 Region or state name.

60765673

5674 minLength: 1, maxLength: 255

5675

60775676 - `timezone: optional string or null`

60785677

60795678 IANA timezone identifier, e.g. "America/Los_Angeles".

60805679

5680 minLength: 1, maxLength: 255

5681

60815682### Beta Managed Agents Agent Tool Config Params

60825683

60835684- `BetaManagedAgentsAgentToolConfigParams = BetaManagedAgentsBashToolConfigParams or BetaManagedAgentsEditToolConfigParams or BetaManagedAgentsReadToolConfigParams or 5 more`

60845685

60855686 Configuration override for a specific tool within a toolset.

60865687

6087 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`

5688 - `BetaManagedAgentsBashToolConfigParams object`

60885689

60895690 Configuration override for the bash tool.

60905691

from line 5693

60925693

60935694 Must be "bash".

60945695

6095 - `"bash"`

6096

60975696 - `enabled: optional boolean or null`

60985697

60995698 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 5701

61025701

61035702 Permission policy for tool execution.

61045703

6105 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5704 - `BetaManagedAgentsAlwaysAllowPolicy object`

61065705

61075706 Tool calls are automatically approved without user confirmation.

61085707

61095708 - `type: "always_allow"`

61105709

6111 - `"always_allow"`

6112

6113 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5710 - `BetaManagedAgentsAlwaysAskPolicy object`

61145711

61155712 Tool calls require user confirmation before execution.

61165713

61175714 - `type: "always_ask"`

61185715

6119 - `"always_ask"`

6120

61215716 - `type: optional "bash"`

61225717

6123 - `"bash"`

6124

6125 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`

5718 - `BetaManagedAgentsEditToolConfigParams object`

61265719

61275720 Configuration override for the edit tool.

61285721

from line 5723

61305723

61315724 Must be "edit".

61325725

6133 - `"edit"`

6134

61355726 - `enabled: optional boolean or null`

61365727

61375728 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 5731

61405731

61415732 Permission policy for tool execution.

61425733

6143 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5734 - `BetaManagedAgentsAlwaysAllowPolicy object`

61445735

61455736 Tool calls are automatically approved without user confirmation.

61465737

6147 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5738 - `BetaManagedAgentsAlwaysAskPolicy object`

61485739

61495740 Tool calls require user confirmation before execution.

61505741

61515742 - `type: optional "edit"`

61525743

6153 - `"edit"`

6154

6155 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`

5744 - `BetaManagedAgentsReadToolConfigParams object`

61565745

61575746 Configuration override for the read tool.

61585747

from line 5749

61605749

61615750 Must be "read".

61625751

6163 - `"read"`

6164

61655752 - `enabled: optional boolean or null`

61665753

61675754 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 5757

61705757

61715758 Permission policy for tool execution.

61725759

6173 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5760 - `BetaManagedAgentsAlwaysAllowPolicy object`

61745761

61755762 Tool calls are automatically approved without user confirmation.

61765763

6177 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5764 - `BetaManagedAgentsAlwaysAskPolicy object`

61785765

61795766 Tool calls require user confirmation before execution.

61805767

61815768 - `type: optional "read"`

61825769

6183 - `"read"`

6184

6185 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`

5770 - `BetaManagedAgentsWriteToolConfigParams object`

61865771

61875772 Configuration override for the write tool.

61885773

from line 5775

61905775

61915776 Must be "write".

61925777

6193 - `"write"`

6194

61955778 - `enabled: optional boolean or null`

61965779

61975780 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 5783

62005783

62015784 Permission policy for tool execution.

62025785

6203 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5786 - `BetaManagedAgentsAlwaysAllowPolicy object`

62045787

62055788 Tool calls are automatically approved without user confirmation.

62065789

6207 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5790 - `BetaManagedAgentsAlwaysAskPolicy object`

62085791

62095792 Tool calls require user confirmation before execution.

62105793

62115794 - `type: optional "write"`

62125795

6213 - `"write"`

6214

6215 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`

5796 - `BetaManagedAgentsGlobToolConfigParams object`

62165797

62175798 Configuration override for the glob tool.

62185799

from line 5801

62205801

62215802 Must be "glob".

62225803

6223 - `"glob"`

6224

62255804 - `enabled: optional boolean or null`

62265805

62275806 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 5809

62305809

62315810 Permission policy for tool execution.

62325811

6233 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5812 - `BetaManagedAgentsAlwaysAllowPolicy object`

62345813

62355814 Tool calls are automatically approved without user confirmation.

62365815

6237 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5816 - `BetaManagedAgentsAlwaysAskPolicy object`

62385817

62395818 Tool calls require user confirmation before execution.

62405819

62415820 - `type: optional "glob"`

62425821

6243 - `"glob"`

6244

6245 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`

5822 - `BetaManagedAgentsGrepToolConfigParams object`

62465823

62475824 Configuration override for the grep tool.

62485825

from line 5827

62505827

62515828 Must be "grep".

62525829

6253 - `"grep"`

6254

62555830 - `enabled: optional boolean or null`

62565831

62575832 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 5835

62605835

62615836 Permission policy for tool execution.

62625837

6263 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5838 - `BetaManagedAgentsAlwaysAllowPolicy object`

62645839

62655840 Tool calls are automatically approved without user confirmation.

62665841

6267 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5842 - `BetaManagedAgentsAlwaysAskPolicy object`

62685843

62695844 Tool calls require user confirmation before execution.

62705845

62715846 - `type: optional "grep"`

62725847

6273 - `"grep"`

6274

6275 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

5848 - `BetaManagedAgentsWebFetchToolConfigParams object`

62765849

62775850 Configuration override for the web_fetch tool.

62785851

from line 5853

62805853

62815854 Must be "web_fetch".

62825855

6283 - `"web_fetch"`

6284

62855856 - `allowed_domains: optional array of string`

62865857

62875858 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 5869

62985869

62995870 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

63005871

5872 format: int32

5873

63015874 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`

63025875

63035876 Permission policy for tool execution.

63045877

6305 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5878 - `BetaManagedAgentsAlwaysAllowPolicy object`

63065879

63075880 Tool calls are automatically approved without user confirmation.

63085881

6309 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5882 - `BetaManagedAgentsAlwaysAskPolicy object`

63105883

63115884 Tool calls require user confirmation before execution.

63125885

63135886 - `type: optional "web_fetch"`

63145887

6315 - `"web_fetch"`

6316

6317 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

5888 - `BetaManagedAgentsWebSearchToolConfigParams object`

63185889

63195890 Configuration override for the web_search tool.

63205891

from line 5893

63225893

63235894 Must be "web_search".

63245895

6325 - `"web_search"`

6326

63275896 - `allowed_domains: optional array of string`

63285897

63295898 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 5909

63405909

63415910 Permission policy for tool execution.

63425911

6343 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5912 - `BetaManagedAgentsAlwaysAllowPolicy object`

63445913

63455914 Tool calls are automatically approved without user confirmation.

63465915

6347 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5916 - `BetaManagedAgentsAlwaysAskPolicy object`

63485917

63495918 Tool calls require user confirmation before execution.

63505919

63515920 - `type: optional "web_search"`

63525921

6353 - `"web_search"`

6354

63555922 - `user_location: optional BetaManagedAgentsUserLocation or null`

63565923

63575924 Approximate user location for search result localization.

from line 5927

63605927

63615928 Location precision. Only "approximate" is supported.

63625929

6363 - `"approximate"`

6364

63655930 - `city: optional string or null`

63665931

63675932 City name.

63685933

5934 minLength: 1, maxLength: 255

5935

63695936 - `country: optional string or null`

63705937

63715938 Two-letter ISO 3166-1 country code, uppercase.

from line 5941

63745941

63755942 Region or state name.

63765943

5944 minLength: 1, maxLength: 255

5945

63775946 - `timezone: optional string or null`

63785947

63795948 IANA timezone identifier, e.g. "America/Los_Angeles".

63805949

5950 minLength: 1, maxLength: 255

5951

63815952### Beta Managed Agents Agent Toolset Default Config

63825953

6383- `BetaManagedAgentsAgentToolsetDefaultConfig object { enabled, permission_policy }`

5954- `BetaManagedAgentsAgentToolsetDefaultConfig object`

63845955

63855956 Resolved default configuration for agent tools.

63865957

from line 5961

63905961

63915962 Permission policy for tool execution.

63925963

6393 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5964 - `BetaManagedAgentsAlwaysAllowPolicy object`

63945965

63955966 Tool calls are automatically approved without user confirmation.

63965967

63975968 - `type: "always_allow"`

63985969

6399 - `"always_allow"`

6400

6401 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5970 - `BetaManagedAgentsAlwaysAskPolicy object`

64025971

64035972 Tool calls require user confirmation before execution.

64045973

64055974 - `type: "always_ask"`

64065975

6407 - `"always_ask"`

6408

64095976### Beta Managed Agents Agent Toolset Default Config Params

64105977

6411- `BetaManagedAgentsAgentToolsetDefaultConfigParams object { enabled, permission_policy }`

5978- `BetaManagedAgentsAgentToolsetDefaultConfigParams object`

64125979

64135980 Default configuration for all tools in a toolset.

64145981

from line 5987

64205987

64215988 Permission policy for tool execution.

64225989

6423 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

5990 - `BetaManagedAgentsAlwaysAllowPolicy object`

64245991

64255992 Tool calls are automatically approved without user confirmation.

64265993

64275994 - `type: "always_allow"`

64285995

6429 - `"always_allow"`

6430

6431 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

5996 - `BetaManagedAgentsAlwaysAskPolicy object`

64325997

64335998 Tool calls require user confirmation before execution.

64345999

64356000 - `type: "always_ask"`

64366001

6437 - `"always_ask"`

6438

64396002### Beta Managed Agents Agent Toolset20260401

64406003

6441- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

6004- `BetaManagedAgentsAgentToolset20260401 object`

64426005

64436006 - `configs: array of BetaManagedAgentsAgentToolConfig`

64446007

6445 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

6008 - `BetaManagedAgentsBashToolConfig object`

64466009

64476010 Configuration for the bash tool.

64486011

from line 6013

64506013

64516014 - `name: "bash"`

64526015

6453 - `"bash"`

6454

64556016 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

64566017

64576018 Permission policy for tool execution.

64586019

6459 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6020 - `BetaManagedAgentsAlwaysAllowPolicy object`

64606021

64616022 Tool calls are automatically approved without user confirmation.

64626023

64636024 - `type: "always_allow"`

64646025

6465 - `"always_allow"`

6466

6467 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6026 - `BetaManagedAgentsAlwaysAskPolicy object`

64686027

64696028 Tool calls require user confirmation before execution.

64706029

64716030 - `type: "always_ask"`

64726031

6473 - `"always_ask"`

6474

64756032 - `type: "bash"`

64766033

6477 - `"bash"`

6478

6479 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

6034 - `BetaManagedAgentsEditToolConfig object`

64806035

64816036 Configuration for the edit tool.

64826037

from line 6039

64846039

64856040 - `name: "edit"`

64866041

6487 - `"edit"`

6488

64896042 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

64906043

64916044 Permission policy for tool execution.

64926045

6493 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6046 - `BetaManagedAgentsAlwaysAllowPolicy object`

64946047

64956048 Tool calls are automatically approved without user confirmation.

64966049

6497 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6050 - `BetaManagedAgentsAlwaysAskPolicy object`

64986051

64996052 Tool calls require user confirmation before execution.

65006053

65016054 - `type: "edit"`

65026055

6503 - `"edit"`

6504

6505 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

6056 - `BetaManagedAgentsReadToolConfig object`

65066057

65076058 Configuration for the read tool.

65086059

from line 6061

65106061

65116062 - `name: "read"`

65126063

6513 - `"read"`

6514

65156064 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

65166065

65176066 Permission policy for tool execution.

65186067

6519 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6068 - `BetaManagedAgentsAlwaysAllowPolicy object`

65206069

65216070 Tool calls are automatically approved without user confirmation.

65226071

6523 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6072 - `BetaManagedAgentsAlwaysAskPolicy object`

65246073

65256074 Tool calls require user confirmation before execution.

65266075

65276076 - `type: "read"`

65286077

6529 - `"read"`

6530

6531 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

6078 - `BetaManagedAgentsWriteToolConfig object`

65326079

65336080 Configuration for the write tool.

65346081

from line 6083

65366083

65376084 - `name: "write"`

65386085

6539 - `"write"`

6540

65416086 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

65426087

65436088 Permission policy for tool execution.

65446089

6545 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6090 - `BetaManagedAgentsAlwaysAllowPolicy object`

65466091

65476092 Tool calls are automatically approved without user confirmation.

65486093

6549 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6094 - `BetaManagedAgentsAlwaysAskPolicy object`

65506095

65516096 Tool calls require user confirmation before execution.

65526097

65536098 - `type: "write"`

65546099

6555 - `"write"`

6556

6557 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

6100 - `BetaManagedAgentsGlobToolConfig object`

65586101

65596102 Configuration for the glob tool.

65606103

from line 6105

65626105

65636106 - `name: "glob"`

65646107

6565 - `"glob"`

6566

65676108 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

65686109

65696110 Permission policy for tool execution.

65706111

6571 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6112 - `BetaManagedAgentsAlwaysAllowPolicy object`

65726113

65736114 Tool calls are automatically approved without user confirmation.

65746115

6575 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6116 - `BetaManagedAgentsAlwaysAskPolicy object`

65766117

65776118 Tool calls require user confirmation before execution.

65786119

65796120 - `type: "glob"`

65806121

6581 - `"glob"`

6582

6583 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

6122 - `BetaManagedAgentsGrepToolConfig object`

65846123

65856124 Configuration for the grep tool.

65866125

from line 6127

65886127

65896128 - `name: "grep"`

65906129

6591 - `"grep"`

6592

65936130 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

65946131

65956132 Permission policy for tool execution.

65966133

6597 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6134 - `BetaManagedAgentsAlwaysAllowPolicy object`

65986135

65996136 Tool calls are automatically approved without user confirmation.

66006137

6601 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6138 - `BetaManagedAgentsAlwaysAskPolicy object`

66026139

66036140 Tool calls require user confirmation before execution.

66046141

66056142 - `type: "grep"`

66066143

6607 - `"grep"`

6608

6609 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

6144 - `BetaManagedAgentsWebFetchToolConfig object`

66106145

66116146 Configuration for the web_fetch tool.

66126147

from line 6149

66146149

66156150 - `name: "web_fetch"`

66166151

6617 - `"web_fetch"`

6618

66196152 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

66206153

66216154 Permission policy for tool execution.

66226155

6623 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6156 - `BetaManagedAgentsAlwaysAllowPolicy object`

66246157

66256158 Tool calls are automatically approved without user confirmation.

66266159

6627 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6160 - `BetaManagedAgentsAlwaysAskPolicy object`

66286161

66296162 Tool calls require user confirmation before execution.

66306163

66316164 - `type: "web_fetch"`

66326165

6633 - `"web_fetch"`

6634

66356166 - `allowed_domains: optional array of string`

66366167

66376168 - `blocked_domains: optional array of string`

66386169

66396170 - `max_content_tokens: optional number or null`

66406171

6641 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

6172 format: int32

6173

6174 - `BetaManagedAgentsWebSearchToolConfig object`

66426175

66436176 Configuration for the web_search tool.

66446177

from line 6179

66466179

66476180 - `name: "web_search"`

66486181

6649 - `"web_search"`

6650

66516182 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

66526183

66536184 Permission policy for tool execution.

66546185

6655 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6186 - `BetaManagedAgentsAlwaysAllowPolicy object`

66566187

66576188 Tool calls are automatically approved without user confirmation.

66586189

6659 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6190 - `BetaManagedAgentsAlwaysAskPolicy object`

66606191

66616192 Tool calls require user confirmation before execution.

66626193

66636194 - `type: "web_search"`

66646195

6665 - `"web_search"`

6666

66676196 - `allowed_domains: optional array of string`

66686197

66696198 - `blocked_domains: optional array of string`

from line 6205

66766205

66776206 Location precision. Only "approximate" is supported.

66786207

6679 - `"approximate"`

6680

66816208 - `city: optional string or null`

66826209

66836210 City name.

66846211

6212 minLength: 1, maxLength: 255

6213

66856214 - `country: optional string or null`

66866215

66876216 Two-letter ISO 3166-1 country code, uppercase.

from line 6219

66906219

66916220 Region or state name.

66926221

6222 minLength: 1, maxLength: 255

6223

66936224 - `timezone: optional string or null`

66946225

66956226 IANA timezone identifier, e.g. "America/Los_Angeles".

66966227

6228 minLength: 1, maxLength: 255

6229

66976230 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

66986231

66996232 Resolved default configuration for agent tools.

from line 6237

67046237

67056238 Permission policy for tool execution.

67066239

6707 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6240 - `BetaManagedAgentsAlwaysAllowPolicy object`

67086241

67096242 Tool calls are automatically approved without user confirmation.

67106243

6711 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6244 - `BetaManagedAgentsAlwaysAskPolicy object`

67126245

67136246 Tool calls require user confirmation before execution.

67146247

67156248 - `type: "agent_toolset_20260401"`

67166249

6717 - `"agent_toolset_20260401"`

6718

67196250### Beta Managed Agents Agent Toolset20260401 Bash Input

67206251

6721- `BetaManagedAgentsAgentToolset20260401BashInput object { command, restart, timeout_ms }`

6252- `BetaManagedAgentsAgentToolset20260401BashInput object`

67226253

67236254 Input payload for the `bash` tool of the

67246255 `agent_toolset_20260401` toolset. All fields are optional;

from line 6271

67406271 Per-call timeout in milliseconds. Defaults to the

67416272 runner-wide tool timeout when omitted or zero.

67426273

6274 minimum: 0

6275

67436276### Beta Managed Agents Agent Toolset20260401 Edit Input

67446277

6745- `BetaManagedAgentsAgentToolset20260401EditInput object { file_path, new_string, old_string, replace_all }`

6278- `BetaManagedAgentsAgentToolset20260401EditInput object`

67466279

67476280 Input payload for the `edit` tool. Performs a string

67486281 replacement in the named file; by default `old_string` must

from line 6300

67676300

67686301### Beta Managed Agents Agent Toolset20260401 Glob Input

67696302

6770- `BetaManagedAgentsAgentToolset20260401GlobInput object { pattern, path }`

6303- `BetaManagedAgentsAgentToolset20260401GlobInput object`

67716304

67726305 Input payload for the `glob` tool. Returns paths matching a

67736306 doublestar glob pattern, newest first.

from line 6318

67856318

67866319### Beta Managed Agents Agent Toolset20260401 Grep Input

67876320

6788- `BetaManagedAgentsAgentToolset20260401GrepInput object { pattern, path }`

6321- `BetaManagedAgentsAgentToolset20260401GrepInput object`

67896322

67906323 Input payload for the `grep` tool. Searches file contents for

67916324 a regular expression, returning matching lines.

from line 6334

68016334

68026335### Beta Managed Agents Agent Toolset20260401 Params

68036336

6804- `BetaManagedAgentsAgentToolset20260401Params object { type, configs, default_config }`

6337- `BetaManagedAgentsAgentToolset20260401Params object`

68056338

68066339 Configuration for built-in agent tools. Use this to enable or disable groups of tools available to the agent.

68076340

68086341 - `type: "agent_toolset_20260401"`

68096342

6810 - `"agent_toolset_20260401"`

6811

68126343 - `configs: optional array of BetaManagedAgentsAgentToolConfigParams`

68136344

68146345 Per-tool configuration overrides.

68156346

6816 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`

6347 - `BetaManagedAgentsBashToolConfigParams object`

68176348

68186349 Configuration override for the bash tool.

68196350

from line 6352

68216352

68226353 Must be "bash".

68236354

6824 - `"bash"`

6825

68266355 - `enabled: optional boolean or null`

68276356

68286357 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6360

68316360

68326361 Permission policy for tool execution.

68336362

6834 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6363 - `BetaManagedAgentsAlwaysAllowPolicy object`

68356364

68366365 Tool calls are automatically approved without user confirmation.

68376366

68386367 - `type: "always_allow"`

68396368

6840 - `"always_allow"`

6841

6842 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6369 - `BetaManagedAgentsAlwaysAskPolicy object`

68436370

68446371 Tool calls require user confirmation before execution.

68456372

68466373 - `type: "always_ask"`

68476374

6848 - `"always_ask"`

6849

68506375 - `type: optional "bash"`

68516376

6852 - `"bash"`

6853

6854 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`

6377 - `BetaManagedAgentsEditToolConfigParams object`

68556378

68566379 Configuration override for the edit tool.

68576380

from line 6382

68596382

68606383 Must be "edit".

68616384

6862 - `"edit"`

6863

68646385 - `enabled: optional boolean or null`

68656386

68666387 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6390

68696390

68706391 Permission policy for tool execution.

68716392

6872 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6393 - `BetaManagedAgentsAlwaysAllowPolicy object`

68736394

68746395 Tool calls are automatically approved without user confirmation.

68756396

6876 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6397 - `BetaManagedAgentsAlwaysAskPolicy object`

68776398

68786399 Tool calls require user confirmation before execution.

68796400

68806401 - `type: optional "edit"`

68816402

6882 - `"edit"`

6883

6884 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`

6403 - `BetaManagedAgentsReadToolConfigParams object`

68856404

68866405 Configuration override for the read tool.

68876406

from line 6408

68896408

68906409 Must be "read".

68916410

6892 - `"read"`

6893

68946411 - `enabled: optional boolean or null`

68956412

68966413 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6416

68996416

69006417 Permission policy for tool execution.

69016418

6902 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6419 - `BetaManagedAgentsAlwaysAllowPolicy object`

69036420

69046421 Tool calls are automatically approved without user confirmation.

69056422

6906 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6423 - `BetaManagedAgentsAlwaysAskPolicy object`

69076424

69086425 Tool calls require user confirmation before execution.

69096426

69106427 - `type: optional "read"`

69116428

6912 - `"read"`

6913

6914 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`

6429 - `BetaManagedAgentsWriteToolConfigParams object`

69156430

69166431 Configuration override for the write tool.

69176432

from line 6434

69196434

69206435 Must be "write".

69216436

6922 - `"write"`

6923

69246437 - `enabled: optional boolean or null`

69256438

69266439 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6442

69296442

69306443 Permission policy for tool execution.

69316444

6932 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6445 - `BetaManagedAgentsAlwaysAllowPolicy object`

69336446

69346447 Tool calls are automatically approved without user confirmation.

69356448

6936 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6449 - `BetaManagedAgentsAlwaysAskPolicy object`

69376450

69386451 Tool calls require user confirmation before execution.

69396452

69406453 - `type: optional "write"`

69416454

6942 - `"write"`

6943

6944 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`

6455 - `BetaManagedAgentsGlobToolConfigParams object`

69456456

69466457 Configuration override for the glob tool.

69476458

from line 6460

69496460

69506461 Must be "glob".

69516462

6952 - `"glob"`

6953

69546463 - `enabled: optional boolean or null`

69556464

69566465 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6468

69596468

69606469 Permission policy for tool execution.

69616470

6962 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6471 - `BetaManagedAgentsAlwaysAllowPolicy object`

69636472

69646473 Tool calls are automatically approved without user confirmation.

69656474

6966 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6475 - `BetaManagedAgentsAlwaysAskPolicy object`

69676476

69686477 Tool calls require user confirmation before execution.

69696478

69706479 - `type: optional "glob"`

69716480

6972 - `"glob"`

6973

6974 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`

6481 - `BetaManagedAgentsGrepToolConfigParams object`

69756482

69766483 Configuration override for the grep tool.

69776484

from line 6486

69796486

69806487 Must be "grep".

69816488

6982 - `"grep"`

6983

69846489 - `enabled: optional boolean or null`

69856490

69866491 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6494

69896494

69906495 Permission policy for tool execution.

69916496

6992 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6497 - `BetaManagedAgentsAlwaysAllowPolicy object`

69936498

69946499 Tool calls are automatically approved without user confirmation.

69956500

6996 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6501 - `BetaManagedAgentsAlwaysAskPolicy object`

69976502

69986503 Tool calls require user confirmation before execution.

69996504

70006505 - `type: optional "grep"`

70016506

7002 - `"grep"`

7003

7004 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

6507 - `BetaManagedAgentsWebFetchToolConfigParams object`

70056508

70066509 Configuration override for the web_fetch tool.

70076510

from line 6512

70096512

70106513 Must be "web_fetch".

70116514

7012 - `"web_fetch"`

7013

70146515 - `allowed_domains: optional array of string`

70156516

70166517 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 6528

70276528

70286529 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

70296530

6531 format: int32

6532

70306533 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`

70316534

70326535 Permission policy for tool execution.

70336536

7034 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6537 - `BetaManagedAgentsAlwaysAllowPolicy object`

70356538

70366539 Tool calls are automatically approved without user confirmation.

70376540

7038 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6541 - `BetaManagedAgentsAlwaysAskPolicy object`

70396542

70406543 Tool calls require user confirmation before execution.

70416544

70426545 - `type: optional "web_fetch"`

70436546

7044 - `"web_fetch"`

7045

7046 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

6547 - `BetaManagedAgentsWebSearchToolConfigParams object`

70476548

70486549 Configuration override for the web_search tool.

70496550

from line 6552

70516552

70526553 Must be "web_search".

70536554

7054 - `"web_search"`

7055

70566555 - `allowed_domains: optional array of string`

70576556

70586557 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 6568

70696568

70706569 Permission policy for tool execution.

70716570

7072 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6571 - `BetaManagedAgentsAlwaysAllowPolicy object`

70736572

70746573 Tool calls are automatically approved without user confirmation.

70756574

7076 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6575 - `BetaManagedAgentsAlwaysAskPolicy object`

70776576

70786577 Tool calls require user confirmation before execution.

70796578

70806579 - `type: optional "web_search"`

70816580

7082 - `"web_search"`

7083

70846581 - `user_location: optional BetaManagedAgentsUserLocation or null`

70856582

70866583 Approximate user location for search result localization.

from line 6586

70896586

70906587 Location precision. Only "approximate" is supported.

70916588

7092 - `"approximate"`

7093

70946589 - `city: optional string or null`

70956590

70966591 City name.

70976592

6593 minLength: 1, maxLength: 255

6594

70986595 - `country: optional string or null`

70996596

71006597 Two-letter ISO 3166-1 country code, uppercase.

from line 6600

71036600

71046601 Region or state name.

71056602

6603 minLength: 1, maxLength: 255

6604

71066605 - `timezone: optional string or null`

71076606

71086607 IANA timezone identifier, e.g. "America/Los_Angeles".

71096608

6609 minLength: 1, maxLength: 255

6610

71106611 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`

71116612

71126613 Default configuration for all tools in a toolset.

from line 6620

71196620

71206621 Permission policy for tool execution.

71216622

7122 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6623 - `BetaManagedAgentsAlwaysAllowPolicy object`

71236624

71246625 Tool calls are automatically approved without user confirmation.

71256626

7126 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6627 - `BetaManagedAgentsAlwaysAskPolicy object`

71276628

71286629 Tool calls require user confirmation before execution.

71296630

71306631### Beta Managed Agents Agent Toolset20260401 Read Input

71316632

7132- `BetaManagedAgentsAgentToolset20260401ReadInput object { file_path, view_range }`

6633- `BetaManagedAgentsAgentToolset20260401ReadInput object`

71336634

71346635 Input payload for the `read` tool. Reads file contents

71356636 relative to the runner's working directory (or absolute when

from line 6646

71456646 range. When omitted the entire file is returned.

71466647 `end_line` of 0 or negative means "to end of file".

71476648

6649 minItems: 2, maxItems: 2

6650

71486651### Beta Managed Agents Agent Toolset20260401 Write Input

71496652

7150- `BetaManagedAgentsAgentToolset20260401WriteInput object { content, file_path }`

6653- `BetaManagedAgentsAgentToolset20260401WriteInput object`

71516654

71526655 Input payload for the `write` tool. Writes (overwriting) the

71536656 entire file contents.

from line 6665

71626665

71636666### Beta Managed Agents Always Allow Policy

71646667

7165- `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6668- `BetaManagedAgentsAlwaysAllowPolicy object`

71666669

71676670 Tool calls are automatically approved without user confirmation.

71686671

71696672 - `type: "always_allow"`

71706673

7171 - `"always_allow"`

7172

71736674### Beta Managed Agents Always Ask Policy

71746675

7175- `BetaManagedAgentsAlwaysAskPolicy object { type }`

6676- `BetaManagedAgentsAlwaysAskPolicy object`

71766677

71776678 Tool calls require user confirmation before execution.

71786679

71796680 - `type: "always_ask"`

71806681

7181 - `"always_ask"`

7182

71836682### Beta Managed Agents Anthropic Skill

71846683

7185- `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

6684- `BetaManagedAgentsAnthropicSkill object`

71866685

71876686 A resolved Anthropic-managed skill.

71886687

from line 6689

71906689

71916690 - `type: "anthropic"`

71926691

7193 - `"anthropic"`

7194

71956692 - `version: string`

71966693

71976694### Beta Managed Agents Anthropic Skill Params

71986695

7199- `BetaManagedAgentsAnthropicSkillParams object { skill_id, type, version }`

6696- `BetaManagedAgentsAnthropicSkillParams object`

72006697

72016698 An Anthropic-managed skill.

72026699

from line 6701

72046701

72056702 Identifier of the Anthropic skill (e.g., "xlsx").

72066703

6704 minLength: 1, maxLength: 64

6705

72076706 - `type: "anthropic"`

72086707

7209 - `"anthropic"`

7210

72116708 - `version: optional string or null`

72126709

72136710 Version to pin. Defaults to latest if omitted.

72146711

6712 minLength: 1, maxLength: 64

6713

72156714### Beta Managed Agents Bash Tool Config

72166715

7217- `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

6716- `BetaManagedAgentsBashToolConfig object`

72186717

72196718 Configuration for the bash tool.

72206719

from line 6721

72226721

72236722 - `name: "bash"`

72246723

7225 - `"bash"`

7226

72276724 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

72286725

72296726 Permission policy for tool execution.

72306727

7231 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6728 - `BetaManagedAgentsAlwaysAllowPolicy object`

72326729

72336730 Tool calls are automatically approved without user confirmation.

72346731

72356732 - `type: "always_allow"`

72366733

7237 - `"always_allow"`

7238

7239 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6734 - `BetaManagedAgentsAlwaysAskPolicy object`

72406735

72416736 Tool calls require user confirmation before execution.

72426737

72436738 - `type: "always_ask"`

72446739

7245 - `"always_ask"`

7246

72476740 - `type: "bash"`

72486741

7249 - `"bash"`

7250

72516742### Beta Managed Agents Bash Tool Config Params

72526743

7253- `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`

6744- `BetaManagedAgentsBashToolConfigParams object`

72546745

72556746 Configuration override for the bash tool.

72566747

from line 6749

72586749

72596750 Must be "bash".

72606751

7261 - `"bash"`

7262

72636752 - `enabled: optional boolean or null`

72646753

72656754 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6757

72686757

72696758 Permission policy for tool execution.

72706759

7271 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6760 - `BetaManagedAgentsAlwaysAllowPolicy object`

72726761

72736762 Tool calls are automatically approved without user confirmation.

72746763

72756764 - `type: "always_allow"`

72766765

7277 - `"always_allow"`

7278

7279 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6766 - `BetaManagedAgentsAlwaysAskPolicy object`

72806767

72816768 Tool calls require user confirmation before execution.

72826769

72836770 - `type: "always_ask"`

72846771

7285 - `"always_ask"`

7286

72876772 - `type: optional "bash"`

72886773

7289 - `"bash"`

7290

72916774### Beta Managed Agents Custom Skill

72926775

7293- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

6776- `BetaManagedAgentsCustomSkill object`

72946777

72956778 A resolved user-created custom skill.

72966779

from line 6781

72986781

72996782 - `type: "custom"`

73006783

7301 - `"custom"`

7302

73036784 - `version: string`

73046785

73056786### Beta Managed Agents Custom Skill Params

73066787

7307- `BetaManagedAgentsCustomSkillParams object { skill_id, type, version }`

6788- `BetaManagedAgentsCustomSkillParams object`

73086789

73096790 A user-created custom skill.

73106791

from line 6793

73126793

73136794 Tagged ID of the custom skill (e.g., "skill_01XJ5...").

73146795

6796 minLength: 1, maxLength: 64

6797

73156798 - `type: "custom"`

73166799

7317 - `"custom"`

7318

73196800 - `version: optional string or null`

73206801

73216802 Version to pin. Defaults to latest if omitted.

73226803

6804 minLength: 1, maxLength: 64

6805

73236806### Beta Managed Agents Custom Tool

73246807

7325- `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

6808- `BetaManagedAgentsCustomTool object`

73266809

73276810 A custom tool as returned in API responses.

73286811

from line 6817

73346817

73356818 - `type: "object"`

73366819

7337 - `"object"`

7338

73396820 - `properties: optional map[unknown] or null`

73406821

73416822 - `required: optional array of string or null`

from line 6825

73446825

73456826 - `type: "custom"`

73466827

7347 - `"custom"`

7348

73496828### Beta Managed Agents Custom Tool Input Schema

73506829

7351- `BetaManagedAgentsCustomToolInputSchema object { type, properties, required }`

6830- `BetaManagedAgentsCustomToolInputSchema object`

73526831

73536832 JSON Schema for custom tool input parameters.

73546833

73556834 - `type: "object"`

73566835

7357 - `"object"`

7358

73596836 - `properties: optional map[unknown] or null`

73606837

73616838 - `required: optional array of string or null`

73626839

73636840### Beta Managed Agents Custom Tool Params

73646841

7365- `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`

6842- `BetaManagedAgentsCustomToolParams object`

73666843

73676844 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.

73686845

from line 6847

73706847

73716848 Description of what the tool does, shown to the agent to help it decide when to use the tool.

73726849

6850 minLength: 1

6851

73736852 - `input_schema: BetaManagedAgentsCustomToolInputSchema`

73746853

73756854 JSON Schema for custom tool input parameters.

73766855

73776856 - `type: "object"`

73786857

7379 - `"object"`

7380

73816858 - `properties: optional map[unknown] or null`

73826859

73836860 - `required: optional array of string or null`

from line 6863

73866863

73876864 Unique name for the tool. 1-128 characters; letters, digits, underscores, and hyphens.

73886865

6866 minLength: 1, maxLength: 128

6867

73896868 - `type: "custom"`

73906869

7391 - `"custom"`

7392

73936870### Beta Managed Agents Edit Tool Config

73946871

7395- `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

6872- `BetaManagedAgentsEditToolConfig object`

73966873

73976874 Configuration for the edit tool.

73986875

from line 6877

74006877

74016878 - `name: "edit"`

74026879

7403 - `"edit"`

7404

74056880 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

74066881

74076882 Permission policy for tool execution.

74086883

7409 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6884 - `BetaManagedAgentsAlwaysAllowPolicy object`

74106885

74116886 Tool calls are automatically approved without user confirmation.

74126887

74136888 - `type: "always_allow"`

74146889

7415 - `"always_allow"`

7416

7417 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6890 - `BetaManagedAgentsAlwaysAskPolicy object`

74186891

74196892 Tool calls require user confirmation before execution.

74206893

74216894 - `type: "always_ask"`

74226895

7423 - `"always_ask"`

7424

74256896 - `type: "edit"`

74266897

7427 - `"edit"`

7428

74296898### Beta Managed Agents Edit Tool Config Params

74306899

7431- `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`

6900- `BetaManagedAgentsEditToolConfigParams object`

74326901

74336902 Configuration override for the edit tool.

74346903

from line 6905

74366905

74376906 Must be "edit".

74386907

7439 - `"edit"`

7440

74416908 - `enabled: optional boolean or null`

74426909

74436910 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 6913

74466913

74476914 Permission policy for tool execution.

74486915

7449 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6916 - `BetaManagedAgentsAlwaysAllowPolicy object`

74506917

74516918 Tool calls are automatically approved without user confirmation.

74526919

74536920 - `type: "always_allow"`

74546921

7455 - `"always_allow"`

7456

7457 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6922 - `BetaManagedAgentsAlwaysAskPolicy object`

74586923

74596924 Tool calls require user confirmation before execution.

74606925

74616926 - `type: "always_ask"`

74626927

7463 - `"always_ask"`

7464

74656928 - `type: optional "edit"`

74666929

7467 - `"edit"`

7468

74696930### Beta Managed Agents Effort High

74706931

7471- `BetaManagedAgentsEffortHigh object { type }`

6932- `BetaManagedAgentsEffortHigh object`

74726933

74736934 High effort. Favors reasoning depth.

74746935

74756936 - `type: "high"`

74766937

7477 - `"high"`

7478

74796938### Beta Managed Agents Effort Low

74806939

7481- `BetaManagedAgentsEffortLow object { type }`

6940- `BetaManagedAgentsEffortLow object`

74826941

74836942 Low effort. Favors latency over reasoning depth.

74846943

74856944 - `type: "low"`

74866945

7487 - `"low"`

7488

74896946### Beta Managed Agents Effort Max

74906947

7491- `BetaManagedAgentsEffortMax object { type }`

6948- `BetaManagedAgentsEffortMax object`

74926949

74936950 Maximum effort. Favors reasoning depth over latency.

74946951

74956952 - `type: "max"`

74966953

7497 - `"max"`

7498

74996954### Beta Managed Agents Effort Medium

75006955

7501- `BetaManagedAgentsEffortMedium object { type }`

6956- `BetaManagedAgentsEffortMedium object`

75026957

75036958 Medium effort. Balances latency and reasoning depth.

75046959

75056960 - `type: "medium"`

75066961

7507 - `"medium"`

7508

75096962### Beta Managed Agents Effort Xhigh

75106963

7511- `BetaManagedAgentsEffortXhigh object { type }`

6964- `BetaManagedAgentsEffortXhigh object`

75126965

75136966 Extra-high effort. Not all models accept this level.

75146967

75156968 - `type: "xhigh"`

75166969

7517 - `"xhigh"`

7518

75196970### Beta Managed Agents Glob Tool Config

75206971

7521- `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

6972- `BetaManagedAgentsGlobToolConfig object`

75226973

75236974 Configuration for the glob tool.

75246975

from line 6977

75266977

75276978 - `name: "glob"`

75286979

7529 - `"glob"`

7530

75316980 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

75326981

75336982 Permission policy for tool execution.

75346983

7535 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

6984 - `BetaManagedAgentsAlwaysAllowPolicy object`

75366985

75376986 Tool calls are automatically approved without user confirmation.

75386987

75396988 - `type: "always_allow"`

75406989

7541 - `"always_allow"`

7542

7543 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

6990 - `BetaManagedAgentsAlwaysAskPolicy object`

75446991

75456992 Tool calls require user confirmation before execution.

75466993

75476994 - `type: "always_ask"`

75486995

7549 - `"always_ask"`

7550

75516996 - `type: "glob"`

75526997

7553 - `"glob"`

7554

75556998### Beta Managed Agents Glob Tool Config Params

75566999

7557- `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`

7000- `BetaManagedAgentsGlobToolConfigParams object`

75587001

75597002 Configuration override for the glob tool.

75607003

from line 7005

75627005

75637006 Must be "glob".

75647007

7565 - `"glob"`

7566

75677008 - `enabled: optional boolean or null`

75687009

75697010 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 7013

75727013

75737014 Permission policy for tool execution.

75747015

7575 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7016 - `BetaManagedAgentsAlwaysAllowPolicy object`

75767017

75777018 Tool calls are automatically approved without user confirmation.

75787019

75797020 - `type: "always_allow"`

75807021

7581 - `"always_allow"`

7582

7583 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7022 - `BetaManagedAgentsAlwaysAskPolicy object`

75847023

75857024 Tool calls require user confirmation before execution.

75867025

75877026 - `type: "always_ask"`

75887027

7589 - `"always_ask"`

7590

75917028 - `type: optional "glob"`

75927029

7593 - `"glob"`

7594

75957030### Beta Managed Agents Grep Tool Config

75967031

7597- `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

7032- `BetaManagedAgentsGrepToolConfig object`

75987033

75997034 Configuration for the grep tool.

76007035

from line 7037

76027037

76037038 - `name: "grep"`

76047039

7605 - `"grep"`

7606

76077040 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

76087041

76097042 Permission policy for tool execution.

76107043

7611 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7044 - `BetaManagedAgentsAlwaysAllowPolicy object`

76127045

76137046 Tool calls are automatically approved without user confirmation.

76147047

76157048 - `type: "always_allow"`

76167049

7617 - `"always_allow"`

7618

7619 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7050 - `BetaManagedAgentsAlwaysAskPolicy object`

76207051

76217052 Tool calls require user confirmation before execution.

76227053

76237054 - `type: "always_ask"`

76247055

7625 - `"always_ask"`

7626

76277056 - `type: "grep"`

76287057

7629 - `"grep"`

7630

76317058### Beta Managed Agents Grep Tool Config Params

76327059

7633- `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`

7060- `BetaManagedAgentsGrepToolConfigParams object`

76347061

76357062 Configuration override for the grep tool.

76367063

from line 7065

76387065

76397066 Must be "grep".

76407067

7641 - `"grep"`

7642

76437068 - `enabled: optional boolean or null`

76447069

76457070 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 7073

76487073

76497074 Permission policy for tool execution.

76507075

7651 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7076 - `BetaManagedAgentsAlwaysAllowPolicy object`

76527077

76537078 Tool calls are automatically approved without user confirmation.

76547079

76557080 - `type: "always_allow"`

76567081

7657 - `"always_allow"`

7658

7659 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7082 - `BetaManagedAgentsAlwaysAskPolicy object`

76607083

76617084 Tool calls require user confirmation before execution.

76627085

76637086 - `type: "always_ask"`

76647087

7665 - `"always_ask"`

7666

76677088 - `type: optional "grep"`

76687089

7669 - `"grep"`

7670

76717090### Beta Managed Agents MCP Server URL Definition

76727091

7673- `BetaManagedAgentsMCPServerURLDefinition object { name, type, url }`

7092- `BetaManagedAgentsMCPServerURLDefinition object`

76747093

76757094 URL-based MCP server connection as returned in API responses.

76767095

from line 7097

76787097

76797098 - `type: "url"`

76807099

7681 - `"url"`

7682

76837100 - `url: string`

76847101

76857102### Beta Managed Agents MCP Tool Config

76867103

7687- `BetaManagedAgentsMCPToolConfig object { enabled, name, permission_policy }`

7104- `BetaManagedAgentsMCPToolConfig object`

76887105

76897106 Resolved configuration for a specific MCP tool.

76907107

from line 7113

76967113

76977114 Permission policy for tool execution.

76987115

7699 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7116 - `BetaManagedAgentsAlwaysAllowPolicy object`

77007117

77017118 Tool calls are automatically approved without user confirmation.

77027119

77037120 - `type: "always_allow"`

77047121

7705 - `"always_allow"`

7706

7707 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7122 - `BetaManagedAgentsAlwaysAskPolicy object`

77087123

77097124 Tool calls require user confirmation before execution.

77107125

77117126 - `type: "always_ask"`

77127127

7713 - `"always_ask"`

7714

77157128### Beta Managed Agents MCP Tool Config Params

77167129

7717- `BetaManagedAgentsMCPToolConfigParams object { name, enabled, permission_policy }`

7130- `BetaManagedAgentsMCPToolConfigParams object`

77187131

77197132 Configuration override for a specific MCP tool.

77207133

from line 7135

77227135

77237136 Name of the MCP tool to configure. 1-128 characters.

77247137

7138 minLength: 1, maxLength: 128

7139

77257140 - `enabled: optional boolean or null`

77267141

77277142 Whether this tool is enabled. Overrides the `default_config` setting.

from line 7145

77307145

77317146 Permission policy for tool execution.

77327147

7733 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7148 - `BetaManagedAgentsAlwaysAllowPolicy object`

77347149

77357150 Tool calls are automatically approved without user confirmation.

77367151

77377152 - `type: "always_allow"`

77387153

7739 - `"always_allow"`

7740

7741 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7154 - `BetaManagedAgentsAlwaysAskPolicy object`

77427155

77437156 Tool calls require user confirmation before execution.

77447157

77457158 - `type: "always_ask"`

77467159

7747 - `"always_ask"`

7748

77497160### Beta Managed Agents MCP Toolset

77507161

7751- `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

7162- `BetaManagedAgentsMCPToolset object`

77527163

77537164 - `configs: array of BetaManagedAgentsMCPToolConfig`

77547165

from line 7171

77607171

77617172 Permission policy for tool execution.

77627173

7763 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7174 - `BetaManagedAgentsAlwaysAllowPolicy object`

77647175

77657176 Tool calls are automatically approved without user confirmation.

77667177

77677178 - `type: "always_allow"`

77687179

7769 - `"always_allow"`

7770

7771 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7180 - `BetaManagedAgentsAlwaysAskPolicy object`

77727181

77737182 Tool calls require user confirmation before execution.

77747183

77757184 - `type: "always_ask"`

77767185

7777 - `"always_ask"`

7778

77797186 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`

77807187

77817188 Resolved default configuration for all tools from an MCP server.

from line 7193

77867193

77877194 Permission policy for tool execution.

77887195

7789 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7196 - `BetaManagedAgentsAlwaysAllowPolicy object`

77907197

77917198 Tool calls are automatically approved without user confirmation.

77927199

7793 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7200 - `BetaManagedAgentsAlwaysAskPolicy object`

77947201

77957202 Tool calls require user confirmation before execution.

77967203

from line 7205

77987205

77997206 - `type: "mcp_toolset"`

78007207

7801 - `"mcp_toolset"`

7802

78037208### Beta Managed Agents MCP Toolset Default Config

78047209

7805- `BetaManagedAgentsMCPToolsetDefaultConfig object { enabled, permission_policy }`

7210- `BetaManagedAgentsMCPToolsetDefaultConfig object`

78067211

78077212 Resolved default configuration for all tools from an MCP server.

78087213

from line 7217

78127217

78137218 Permission policy for tool execution.

78147219

7815 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7220 - `BetaManagedAgentsAlwaysAllowPolicy object`

78167221

78177222 Tool calls are automatically approved without user confirmation.

78187223

78197224 - `type: "always_allow"`

78207225

7821 - `"always_allow"`

7822

7823 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7226 - `BetaManagedAgentsAlwaysAskPolicy object`

78247227

78257228 Tool calls require user confirmation before execution.

78267229

78277230 - `type: "always_ask"`

78287231

7829 - `"always_ask"`

7830

78317232### Beta Managed Agents MCP Toolset Default Config Params

78327233

7833- `BetaManagedAgentsMCPToolsetDefaultConfigParams object { enabled, permission_policy }`

7234- `BetaManagedAgentsMCPToolsetDefaultConfigParams object`

78347235

78357236 Default configuration for all tools from an MCP server.

78367237

from line 7243

78427243

78437244 Permission policy for tool execution.

78447245

7845 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7246 - `BetaManagedAgentsAlwaysAllowPolicy object`

78467247

78477248 Tool calls are automatically approved without user confirmation.

78487249

78497250 - `type: "always_allow"`

78507251

7851 - `"always_allow"`

7852

7853 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7252 - `BetaManagedAgentsAlwaysAskPolicy object`

78547253

78557254 Tool calls require user confirmation before execution.

78567255

78577256 - `type: "always_ask"`

78587257

7859 - `"always_ask"`

7860

78617258### Beta Managed Agents MCP Toolset Params

78627259

7863- `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`

7260- `BetaManagedAgentsMCPToolsetParams object`

78647261

78657262 Configuration for tools from an MCP server defined in `mcp_servers`.

78667263

from line 7265

78687265

78697266 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.

78707267

7268 minLength: 1, maxLength: 255

7269

78717270 - `type: "mcp_toolset"`

78727271

7873 - `"mcp_toolset"`

7874

78757272 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`

78767273

78777274 Per-tool configuration overrides.

from line 7277

78807277

78817278 Name of the MCP tool to configure. 1-128 characters.

78827279

7280 minLength: 1, maxLength: 128

7281

78837282 - `enabled: optional boolean or null`

78847283

78857284 Whether this tool is enabled. Overrides the `default_config` setting.

from line 7287

78887287

78897288 Permission policy for tool execution.

78907289

7891 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7290 - `BetaManagedAgentsAlwaysAllowPolicy object`

78927291

78937292 Tool calls are automatically approved without user confirmation.

78947293

78957294 - `type: "always_allow"`

78967295

7897 - `"always_allow"`

7898

7899 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7296 - `BetaManagedAgentsAlwaysAskPolicy object`

79007297

79017298 Tool calls require user confirmation before execution.

79027299

79037300 - `type: "always_ask"`

79047301

7905 - `"always_ask"`

7906

79077302 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`

79087303

79097304 Default configuration for all tools from an MCP server.

from line 7311

79167311

79177312 Permission policy for tool execution.

79187313

7919 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7314 - `BetaManagedAgentsAlwaysAllowPolicy object`

79207315

79217316 Tool calls are automatically approved without user confirmation.

79227317

7923 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7318 - `BetaManagedAgentsAlwaysAskPolicy object`

79247319

79257320 Tool calls require user confirmation before execution.

79267321

from line 7389

79947389

79957390### Beta Managed Agents Model Config

79967391

7997- `BetaManagedAgentsModelConfig object { id, effort, inference_geo, speed }`

7392- `BetaManagedAgentsModelConfig object`

79987393

79997394 Model identifier and configuration.

80007395

from line 7463

80687463

80697464 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

80707465

8071 - `BetaManagedAgentsEffortLow object { type }`

7466 - `BetaManagedAgentsEffortLow object`

80727467

80737468 Low effort. Favors latency over reasoning depth.

80747469

80757470 - `type: "low"`

80767471

8077 - `"low"`

8078

8079 - `BetaManagedAgentsEffortMedium object { type }`

7472 - `BetaManagedAgentsEffortMedium object`

80807473

80817474 Medium effort. Balances latency and reasoning depth.

80827475

80837476 - `type: "medium"`

80847477

8085 - `"medium"`

8086

8087 - `BetaManagedAgentsEffortHigh object { type }`

7478 - `BetaManagedAgentsEffortHigh object`

80887479

80897480 High effort. Favors reasoning depth.

80907481

80917482 - `type: "high"`

80927483

8093 - `"high"`

8094

8095 - `BetaManagedAgentsEffortXhigh object { type }`

7484 - `BetaManagedAgentsEffortXhigh object`

80967485

80977486 Extra-high effort. Not all models accept this level.

80987487

80997488 - `type: "xhigh"`

81007489

8101 - `"xhigh"`

8102

8103 - `BetaManagedAgentsEffortMax object { type }`

7490 - `BetaManagedAgentsEffortMax object`

81047491

81057492 Maximum effort. Favors reasoning depth over latency.

81067493

81077494 - `type: "max"`

81087495

8109 - `"max"`

8110

81117496 - `inference_geo: optional string`

81127497

81137498 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 7507

81227507

81237508### Beta Managed Agents Model Config Params

81247509

8125- `BetaManagedAgentsModelConfigParams object { id, effort, inference_geo, speed }`

7510- `BetaManagedAgentsModelConfigParams object`

81267511

81277512 An object that defines additional configuration control over model use

81287513

from line 7595

82107595

82117596 - `"max"`

82127597

8213 - `BetaManagedAgentsEffortLow object { type }`

7598 - `BetaManagedAgentsEffortLow object`

82147599

82157600 Low effort. Favors latency over reasoning depth.

82167601

82177602 - `type: "low"`

82187603

8219 - `"low"`

8220

8221 - `BetaManagedAgentsEffortMedium object { type }`

7604 - `BetaManagedAgentsEffortMedium object`

82227605

82237606 Medium effort. Balances latency and reasoning depth.

82247607

82257608 - `type: "medium"`

82267609

8227 - `"medium"`

8228

8229 - `BetaManagedAgentsEffortHigh object { type }`

7610 - `BetaManagedAgentsEffortHigh object`

82307611

82317612 High effort. Favors reasoning depth.

82327613

82337614 - `type: "high"`

82347615

8235 - `"high"`

8236

8237 - `BetaManagedAgentsEffortXhigh object { type }`

7616 - `BetaManagedAgentsEffortXhigh object`

82387617

82397618 Extra-high effort. Not all models accept this level.

82407619

82417620 - `type: "xhigh"`

82427621

8243 - `"xhigh"`

8244

8245 - `BetaManagedAgentsEffortMax object { type }`

7622 - `BetaManagedAgentsEffortMax object`

82467623

82477624 Maximum effort. Favors reasoning depth over latency.

82487625

82497626 - `type: "max"`

82507627

8251 - `"max"`

8252

82537628 - `inference_geo: optional string or null`

82547629

82557630 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 7639

82647639

82657640### Beta Managed Agents Multiagent Coordinator

82667641

8267- `BetaManagedAgentsMultiagentCoordinator object { agents, type }`

7642- `BetaManagedAgentsMultiagentCoordinator object`

82687643

82697644 Resolved coordinator topology with a concrete agent roster.

82707645

from line 7647

82727647

82737648 Agents the coordinator may spawn as session threads, each resolved to a specific version.

82747649

8275 - `BetaManagedAgentsAgentReference object { id, type, version }`

7650 - `BetaManagedAgentsAgentReference object`

82767651

82777652 A resolved agent reference with a concrete version.

82787653

from line 7655

82807655

82817656 - `type: "agent"`

82827657

8283 - `"agent"`

8284

82857658 - `version: number`

82867659

8287 - `BetaManagedAgentsAdvisor object { model, type }`

7660 format: int32

7661

7662 - `BetaManagedAgentsAdvisor object`

82887663

82897664 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

82907665

from line 7669

82947669

82957670 - `type: "advisor"`

82967671

8297 - `"advisor"`

8298

82997672 - `type: "coordinator"`

83007673

8301 - `"coordinator"`

8302

83037674### Beta Managed Agents Multiagent Coordinator Params

83047675

8305- `BetaManagedAgentsMultiagentCoordinatorParams object { agents, type }`

7676- `BetaManagedAgentsMultiagentCoordinatorParams object`

83067677

83077678 A coordinator topology: the session's primary thread orchestrates work by spawning session threads, each running an agent drawn from the `agents` roster.

83087679

from line 7683

83127683

83137684 - `string`

83147685

8315 - `BetaManagedAgentsAgentParams object { id, type, version }`

7686 - `BetaManagedAgentsAgentParams object`

83167687

83177688 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version

83187689

from line 7691

83207691

83217692 The `agent` ID.

83227693

7694 minLength: 1, maxLength: 128

7695

83237696 - `type: "agent"`

83247697

8325 - `"agent"`

8326

83277698 - `version: optional number`

83287699

83297700 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.

83307701

8331 - `BetaManagedAgentsMultiagentSelfParams object { type }`

7702 format: int32

7703

7704 - `BetaManagedAgentsMultiagentSelfParams object`

83327705

83337706 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.

83347707

83357708 - `type: "self"`

83367709

8337 - `"self"`

8338

8339 - `BetaManagedAgentsAdvisorParams object { model, type }`

7710 - `BetaManagedAgentsAdvisorParams object`

83407711

83417712 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`.

83427713

from line 7715

83447715

83457716 A Claude model id. The model must be permitted as an advisor for this agent's model — see the sessions/threads/advisor spec.

83467717

7718 minLength: 1, maxLength: 256

7719

83477720 - `type: "advisor"`

83487721

8349 - `"advisor"`

8350

83517722 - `type: "coordinator"`

83527723

8353 - `"coordinator"`

8354

83557724### Beta Managed Agents Multiagent Self Params

83567725

8357- `BetaManagedAgentsMultiagentSelfParams object { type }`

7726- `BetaManagedAgentsMultiagentSelfParams object`

83587727

83597728 Sentinel roster entry meaning "the agent that owns this configuration". Resolved server-side to a concrete agent reference.

83607729

83617730 - `type: "self"`

83627731

8363 - `"self"`

8364

83657732### Beta Managed Agents Read Tool Config

83667733

8367- `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

7734- `BetaManagedAgentsReadToolConfig object`

83687735

83697736 Configuration for the read tool.

83707737

from line 7739

83727739

83737740 - `name: "read"`

83747741

8375 - `"read"`

8376

83777742 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

83787743

83797744 Permission policy for tool execution.

83807745

8381 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7746 - `BetaManagedAgentsAlwaysAllowPolicy object`

83827747

83837748 Tool calls are automatically approved without user confirmation.

83847749

83857750 - `type: "always_allow"`

83867751

8387 - `"always_allow"`

8388

8389 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7752 - `BetaManagedAgentsAlwaysAskPolicy object`

83907753

83917754 Tool calls require user confirmation before execution.

83927755

83937756 - `type: "always_ask"`

83947757

8395 - `"always_ask"`

8396

83977758 - `type: "read"`

83987759

8399 - `"read"`

8400

84017760### Beta Managed Agents Read Tool Config Params

84027761

8403- `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`

7762- `BetaManagedAgentsReadToolConfigParams object`

84047763

84057764 Configuration override for the read tool.

84067765

from line 7767

84087767

84097768 Must be "read".

84107769

8411 - `"read"`

8412

84137770 - `enabled: optional boolean or null`

84147771

84157772 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 7775

84187775

84197776 Permission policy for tool execution.

84207777

8421 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7778 - `BetaManagedAgentsAlwaysAllowPolicy object`

84227779

84237780 Tool calls are automatically approved without user confirmation.

84247781

84257782 - `type: "always_allow"`

84267783

8427 - `"always_allow"`

8428

8429 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7784 - `BetaManagedAgentsAlwaysAskPolicy object`

84307785

84317786 Tool calls require user confirmation before execution.

84327787

84337788 - `type: "always_ask"`

84347789

8435 - `"always_ask"`

8436

84377790 - `type: optional "read"`

84387791

8439 - `"read"`

8440

84417792### Beta Managed Agents Session Thread Agent

84427793

8443- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`

7794- `BetaManagedAgentsSessionThreadAgent object`

84447795

84457796 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.

84467797

from line 7805

84547805

84557806 - `type: "url"`

84567807

8457 - `"url"`

8458

84597808 - `url: string`

84607809

84617810 - `model: BetaManagedAgentsModelConfig`

from line 7881

85327881

85337882 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

85347883

8535 - `BetaManagedAgentsEffortLow object { type }`

7884 - `BetaManagedAgentsEffortLow object`

85367885

85377886 Low effort. Favors latency over reasoning depth.

85387887

85397888 - `type: "low"`

85407889

8541 - `"low"`

8542

8543 - `BetaManagedAgentsEffortMedium object { type }`

7890 - `BetaManagedAgentsEffortMedium object`

85447891

85457892 Medium effort. Balances latency and reasoning depth.

85467893

85477894 - `type: "medium"`

85487895

8549 - `"medium"`

8550

8551 - `BetaManagedAgentsEffortHigh object { type }`

7896 - `BetaManagedAgentsEffortHigh object`

85527897

85537898 High effort. Favors reasoning depth.

85547899

85557900 - `type: "high"`

85567901

8557 - `"high"`

8558

8559 - `BetaManagedAgentsEffortXhigh object { type }`

7902 - `BetaManagedAgentsEffortXhigh object`

85607903

85617904 Extra-high effort. Not all models accept this level.

85627905

85637906 - `type: "xhigh"`

85647907

8565 - `"xhigh"`

8566

8567 - `BetaManagedAgentsEffortMax object { type }`

7908 - `BetaManagedAgentsEffortMax object`

85687909

85697910 Maximum effort. Favors reasoning depth over latency.

85707911

85717912 - `type: "max"`

85727913

8573 - `"max"`

8574

85757914 - `inference_geo: optional string`

85767915

85777916 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 7927

85887927

85897928 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

85907929

8591 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

7930 - `BetaManagedAgentsAnthropicSkill object`

85927931

85937932 A resolved Anthropic-managed skill.

85947933

from line 7935

85967935

85977936 - `type: "anthropic"`

85987937

8599 - `"anthropic"`

8600

86017938 - `version: string`

86027939

8603 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

7940 - `BetaManagedAgentsCustomSkill object`

86047941

86057942 A resolved user-created custom skill.

86067943

from line 7945

86087945

86097946 - `type: "custom"`

86107947

8611 - `"custom"`

8612

86137948 - `version: string`

86147949

86157950 - `system: string or null`

86167951

86177952 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

86187953

8619 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

7954 - `BetaManagedAgentsAgentToolset20260401 object`

86207955

86217956 - `configs: array of BetaManagedAgentsAgentToolConfig`

86227957

8623 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

7958 - `BetaManagedAgentsBashToolConfig object`

86247959

86257960 Configuration for the bash tool.

86267961

from line 7963

86287963

86297964 - `name: "bash"`

86307965

8631 - `"bash"`

8632

86337966 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

86347967

86357968 Permission policy for tool execution.

86367969

8637 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7970 - `BetaManagedAgentsAlwaysAllowPolicy object`

86387971

86397972 Tool calls are automatically approved without user confirmation.

86407973

86417974 - `type: "always_allow"`

86427975

8643 - `"always_allow"`

8644

8645 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

7976 - `BetaManagedAgentsAlwaysAskPolicy object`

86467977

86477978 Tool calls require user confirmation before execution.

86487979

86497980 - `type: "always_ask"`

86507981

8651 - `"always_ask"`

8652

86537982 - `type: "bash"`

86547983

8655 - `"bash"`

8656

8657 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

7984 - `BetaManagedAgentsEditToolConfig object`

86587985

86597986 Configuration for the edit tool.

86607987

from line 7989

86627989

86637990 - `name: "edit"`

86647991

8665 - `"edit"`

8666

86677992 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

86687993

86697994 Permission policy for tool execution.

86707995

8671 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

7996 - `BetaManagedAgentsAlwaysAllowPolicy object`

86727997

86737998 Tool calls are automatically approved without user confirmation.

86747999

8675 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8000 - `BetaManagedAgentsAlwaysAskPolicy object`

86768001

86778002 Tool calls require user confirmation before execution.

86788003

86798004 - `type: "edit"`

86808005

8681 - `"edit"`

8682

8683 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

8006 - `BetaManagedAgentsReadToolConfig object`

86848007

86858008 Configuration for the read tool.

86868009

from line 8011

86888011

86898012 - `name: "read"`

86908013

8691 - `"read"`

8692

86938014 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

86948015

86958016 Permission policy for tool execution.

86968017

8697 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8018 - `BetaManagedAgentsAlwaysAllowPolicy object`

86988019

86998020 Tool calls are automatically approved without user confirmation.

87008021

8701 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8022 - `BetaManagedAgentsAlwaysAskPolicy object`

87028023

87038024 Tool calls require user confirmation before execution.

87048025

87058026 - `type: "read"`

87068027

8707 - `"read"`

8708

8709 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

8028 - `BetaManagedAgentsWriteToolConfig object`

87108029

87118030 Configuration for the write tool.

87128031

from line 8033

87148033

87158034 - `name: "write"`

87168035

8717 - `"write"`

8718

87198036 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

87208037

87218038 Permission policy for tool execution.

87228039

8723 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8040 - `BetaManagedAgentsAlwaysAllowPolicy object`

87248041

87258042 Tool calls are automatically approved without user confirmation.

87268043

8727 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8044 - `BetaManagedAgentsAlwaysAskPolicy object`

87288045

87298046 Tool calls require user confirmation before execution.

87308047

87318048 - `type: "write"`

87328049

8733 - `"write"`

8734

8735 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

8050 - `BetaManagedAgentsGlobToolConfig object`

87368051

87378052 Configuration for the glob tool.

87388053

from line 8055

87408055

87418056 - `name: "glob"`

87428057

8743 - `"glob"`

8744

87458058 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

87468059

87478060 Permission policy for tool execution.

87488061

8749 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8062 - `BetaManagedAgentsAlwaysAllowPolicy object`

87508063

87518064 Tool calls are automatically approved without user confirmation.

87528065

8753 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8066 - `BetaManagedAgentsAlwaysAskPolicy object`

87548067

87558068 Tool calls require user confirmation before execution.

87568069

87578070 - `type: "glob"`

87588071

8759 - `"glob"`

8760

8761 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

8072 - `BetaManagedAgentsGrepToolConfig object`

87628073

87638074 Configuration for the grep tool.

87648075

from line 8077

87668077

87678078 - `name: "grep"`

87688079

8769 - `"grep"`

8770

87718080 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

87728081

87738082 Permission policy for tool execution.

87748083

8775 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8084 - `BetaManagedAgentsAlwaysAllowPolicy object`

87768085

87778086 Tool calls are automatically approved without user confirmation.

87788087

8779 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8088 - `BetaManagedAgentsAlwaysAskPolicy object`

87808089

87818090 Tool calls require user confirmation before execution.

87828091

87838092 - `type: "grep"`

87848093

8785 - `"grep"`

8786

8787 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

8094 - `BetaManagedAgentsWebFetchToolConfig object`

87888095

87898096 Configuration for the web_fetch tool.

87908097

from line 8099

87928099

87938100 - `name: "web_fetch"`

87948101

8795 - `"web_fetch"`

8796

87978102 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

87988103

87998104 Permission policy for tool execution.

88008105

8801 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8106 - `BetaManagedAgentsAlwaysAllowPolicy object`

88028107

88038108 Tool calls are automatically approved without user confirmation.

88048109

8805 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8110 - `BetaManagedAgentsAlwaysAskPolicy object`

88068111

88078112 Tool calls require user confirmation before execution.

88088113

88098114 - `type: "web_fetch"`

88108115

8811 - `"web_fetch"`

8812

88138116 - `allowed_domains: optional array of string`

88148117

88158118 - `blocked_domains: optional array of string`

88168119

88178120 - `max_content_tokens: optional number or null`

88188121

8819 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

8122 format: int32

8123

8124 - `BetaManagedAgentsWebSearchToolConfig object`

88208125

88218126 Configuration for the web_search tool.

88228127

from line 8129

88248129

88258130 - `name: "web_search"`

88268131

8827 - `"web_search"`

8828

88298132 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

88308133

88318134 Permission policy for tool execution.

88328135

8833 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8136 - `BetaManagedAgentsAlwaysAllowPolicy object`

88348137

88358138 Tool calls are automatically approved without user confirmation.

88368139

8837 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8140 - `BetaManagedAgentsAlwaysAskPolicy object`

88388141

88398142 Tool calls require user confirmation before execution.

88408143

88418144 - `type: "web_search"`

88428145

8843 - `"web_search"`

8844

88458146 - `allowed_domains: optional array of string`

88468147

88478148 - `blocked_domains: optional array of string`

from line 8155

88548155

88558156 Location precision. Only "approximate" is supported.

88568157

8857 - `"approximate"`

8858

88598158 - `city: optional string or null`

88608159

88618160 City name.

88628161

8162 minLength: 1, maxLength: 255

8163

88638164 - `country: optional string or null`

88648165

88658166 Two-letter ISO 3166-1 country code, uppercase.

from line 8169

88688169

88698170 Region or state name.

88708171

8172 minLength: 1, maxLength: 255

8173

88718174 - `timezone: optional string or null`

88728175

88738176 IANA timezone identifier, e.g. "America/Los_Angeles".

88748177

8178 minLength: 1, maxLength: 255

8179

88758180 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

88768181

88778182 Resolved default configuration for agent tools.

from line 8187

88828187

88838188 Permission policy for tool execution.

88848189

8885 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8190 - `BetaManagedAgentsAlwaysAllowPolicy object`

88868191

88878192 Tool calls are automatically approved without user confirmation.

88888193

8889 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8194 - `BetaManagedAgentsAlwaysAskPolicy object`

88908195

88918196 Tool calls require user confirmation before execution.

88928197

88938198 - `type: "agent_toolset_20260401"`

88948199

8895 - `"agent_toolset_20260401"`

8896

8897 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

8200 - `BetaManagedAgentsMCPToolset object`

88988201

88998202 - `configs: array of BetaManagedAgentsMCPToolConfig`

89008203

from line 8209

89068209

89078210 Permission policy for tool execution.

89088211

8909 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8212 - `BetaManagedAgentsAlwaysAllowPolicy object`

89108213

89118214 Tool calls are automatically approved without user confirmation.

89128215

8913 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8216 - `BetaManagedAgentsAlwaysAskPolicy object`

89148217

89158218 Tool calls require user confirmation before execution.

89168219

from line 8227

89248227

89258228 Permission policy for tool execution.

89268229

8927 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8230 - `BetaManagedAgentsAlwaysAllowPolicy object`

89288231

89298232 Tool calls are automatically approved without user confirmation.

89308233

8931 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8234 - `BetaManagedAgentsAlwaysAskPolicy object`

89328235

89338236 Tool calls require user confirmation before execution.

89348237

from line 8239

89368239

89378240 - `type: "mcp_toolset"`

89388241

8939 - `"mcp_toolset"`

8940

8941 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

8242 - `BetaManagedAgentsCustomTool object`

89428243

89438244 A custom tool as returned in API responses.

89448245

from line 8251

89508251

89518252 - `type: "object"`

89528253

8953 - `"object"`

8954

89558254 - `properties: optional map[unknown] or null`

89568255

89578256 - `required: optional array of string or null`

from line 8259

89608259

89618260 - `type: "custom"`

89628261

8963 - `"custom"`

8964

89658262 - `type: "agent"`

89668263

8967 - `"agent"`

8968

89698264 - `version: number`

89708265

8266 format: int32

8267

89718268### Beta Managed Agents Skill Params

89728269

89738270- `BetaManagedAgentsSkillParams = BetaManagedAgentsAnthropicSkillParams or BetaManagedAgentsCustomSkillParams`

89748271

89758272 Skill to load in the session container.

89768273

8977 - `BetaManagedAgentsAnthropicSkillParams object { skill_id, type, version }`

8274 - `BetaManagedAgentsAnthropicSkillParams object`

89788275

89798276 An Anthropic-managed skill.

89808277

from line 8279

89828279

89838280 Identifier of the Anthropic skill (e.g., "xlsx").

89848281

8282 minLength: 1, maxLength: 64

8283

89858284 - `type: "anthropic"`

89868285

8987 - `"anthropic"`

8988

89898286 - `version: optional string or null`

89908287

89918288 Version to pin. Defaults to latest if omitted.

89928289

8993 - `BetaManagedAgentsCustomSkillParams object { skill_id, type, version }`

8290 minLength: 1, maxLength: 64

8291

8292 - `BetaManagedAgentsCustomSkillParams object`

89948293

89958294 A user-created custom skill.

89968295

from line 8297

89988297

89998298 Tagged ID of the custom skill (e.g., "skill_01XJ5...").

90008299

8300 minLength: 1, maxLength: 64

8301

90018302 - `type: "custom"`

90028303

9003 - `"custom"`

9004

90058304 - `version: optional string or null`

90068305

90078306 Version to pin. Defaults to latest if omitted.

90088307

8308 minLength: 1, maxLength: 64

8309

90098310### Beta Managed Agents URL MCP Server Params

90108311

9011- `BetaManagedAgentsURLMCPServerParams object { name, type, url }`

8312- `BetaManagedAgentsURLMCPServerParams object`

90128313

90138314 URL-based MCP server connection.

90148315

from line 8317

90168317

90178318 Unique name for this server, referenced by mcp_toolset configurations. 1-255 characters.

90188319

8320 minLength: 1, maxLength: 255

8321

90198322 - `type: "url"`

90208323

9021 - `"url"`

9022

90238324 - `url: string`

90248325

90258326 Endpoint URL for the MCP server.

90268327

8328 maxLength: 2048

8329

90278330### Beta Managed Agents User Location

90288331

9029- `BetaManagedAgentsUserLocation object { type, city, country, 2 more }`

8332- `BetaManagedAgentsUserLocation object`

90308333

90318334 Approximate user location for search result localization.

90328335

from line 8337

90348337

90358338 Location precision. Only "approximate" is supported.

90368339

9037 - `"approximate"`

9038

90398340 - `city: optional string or null`

90408341

90418342 City name.

90428343

8344 minLength: 1, maxLength: 255

8345

90438346 - `country: optional string or null`

90448347

90458348 Two-letter ISO 3166-1 country code, uppercase.

from line 8351

90488351

90498352 Region or state name.

90508353

8354 minLength: 1, maxLength: 255

8355

90518356 - `timezone: optional string or null`

90528357

90538358 IANA timezone identifier, e.g. "America/Los_Angeles".

90548359

8360 minLength: 1, maxLength: 255

8361

90558362### Beta Managed Agents Web Fetch Tool Config

90568363

9057- `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

8364- `BetaManagedAgentsWebFetchToolConfig object`

90588365

90598366 Configuration for the web_fetch tool.

90608367

from line 8369

90628369

90638370 - `name: "web_fetch"`

90648371

9065 - `"web_fetch"`

9066

90678372 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

90688373

90698374 Permission policy for tool execution.

90708375

9071 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8376 - `BetaManagedAgentsAlwaysAllowPolicy object`

90728377

90738378 Tool calls are automatically approved without user confirmation.

90748379

90758380 - `type: "always_allow"`

90768381

9077 - `"always_allow"`

9078

9079 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8382 - `BetaManagedAgentsAlwaysAskPolicy object`

90808383

90818384 Tool calls require user confirmation before execution.

90828385

90838386 - `type: "always_ask"`

90848387

9085 - `"always_ask"`

9086

90878388 - `type: "web_fetch"`

90888389

9089 - `"web_fetch"`

9090

90918390 - `allowed_domains: optional array of string`

90928391

90938392 - `blocked_domains: optional array of string`

90948393

90958394 - `max_content_tokens: optional number or null`

90968395

8396 format: int32

8397

90978398### Beta Managed Agents Web Fetch Tool Config Params

90988399

9099- `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

8400- `BetaManagedAgentsWebFetchToolConfigParams object`

91008401

91018402 Configuration override for the web_fetch tool.

91028403

from line 8405

91048405

91058406 Must be "web_fetch".

91068407

9107 - `"web_fetch"`

9108

91098408 - `allowed_domains: optional array of string`

91108409

91118410 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 8421

91228421

91238422 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.

91248423

8424 format: int32

8425

91258426 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`

91268427

91278428 Permission policy for tool execution.

91288429

9129 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8430 - `BetaManagedAgentsAlwaysAllowPolicy object`

91308431

91318432 Tool calls are automatically approved without user confirmation.

91328433

91338434 - `type: "always_allow"`

91348435

9135 - `"always_allow"`

9136

9137 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8436 - `BetaManagedAgentsAlwaysAskPolicy object`

91388437

91398438 Tool calls require user confirmation before execution.

91408439

91418440 - `type: "always_ask"`

91428441

9143 - `"always_ask"`

9144

91458442 - `type: optional "web_fetch"`

91468443

9147 - `"web_fetch"`

9148

91498444### Beta Managed Agents Web Search Tool Config

91508445

9151- `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

8446- `BetaManagedAgentsWebSearchToolConfig object`

91528447

91538448 Configuration for the web_search tool.

91548449

from line 8451

91568451

91578452 - `name: "web_search"`

91588453

9159 - `"web_search"`

9160

91618454 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

91628455

91638456 Permission policy for tool execution.

91648457

9165 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8458 - `BetaManagedAgentsAlwaysAllowPolicy object`

91668459

91678460 Tool calls are automatically approved without user confirmation.

91688461

91698462 - `type: "always_allow"`

91708463

9171 - `"always_allow"`

9172

9173 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8464 - `BetaManagedAgentsAlwaysAskPolicy object`

91748465

91758466 Tool calls require user confirmation before execution.

91768467

91778468 - `type: "always_ask"`

91788469

9179 - `"always_ask"`

9180

91818470 - `type: "web_search"`

91828471

9183 - `"web_search"`

9184

91858472 - `allowed_domains: optional array of string`

91868473

91878474 - `blocked_domains: optional array of string`

from line 8481

91948481

91958482 Location precision. Only "approximate" is supported.

91968483

9197 - `"approximate"`

9198

91998484 - `city: optional string or null`

92008485

92018486 City name.

92028487

8488 minLength: 1, maxLength: 255

8489

92038490 - `country: optional string or null`

92048491

92058492 Two-letter ISO 3166-1 country code, uppercase.

from line 8495

92088495

92098496 Region or state name.

92108497

8498 minLength: 1, maxLength: 255

8499

92118500 - `timezone: optional string or null`

92128501

92138502 IANA timezone identifier, e.g. "America/Los_Angeles".

92148503

8504 minLength: 1, maxLength: 255

8505

92158506### Beta Managed Agents Web Search Tool Config Params

92168507

9217- `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`

8508- `BetaManagedAgentsWebSearchToolConfigParams object`

92188509

92198510 Configuration override for the web_search tool.

92208511

from line 8513

92228513

92238514 Must be "web_search".

92248515

9225 - `"web_search"`

9226

92278516 - `allowed_domains: optional array of string`

92288517

92298518 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 8529

92408529

92418530 Permission policy for tool execution.

92428531

9243 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8532 - `BetaManagedAgentsAlwaysAllowPolicy object`

92448533

92458534 Tool calls are automatically approved without user confirmation.

92468535

92478536 - `type: "always_allow"`

92488537

9249 - `"always_allow"`

9250

9251 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8538 - `BetaManagedAgentsAlwaysAskPolicy object`

92528539

92538540 Tool calls require user confirmation before execution.

92548541

92558542 - `type: "always_ask"`

92568543

9257 - `"always_ask"`

9258

92598544 - `type: optional "web_search"`

92608545

9261 - `"web_search"`

9262

92638546 - `user_location: optional BetaManagedAgentsUserLocation or null`

92648547

92658548 Approximate user location for search result localization.

from line 8551

92688551

92698552 Location precision. Only "approximate" is supported.

92708553

9271 - `"approximate"`

9272

92738554 - `city: optional string or null`

92748555

92758556 City name.

92768557

8558 minLength: 1, maxLength: 255

8559

92778560 - `country: optional string or null`

92788561

92798562 Two-letter ISO 3166-1 country code, uppercase.

from line 8565

92828565

92838566 Region or state name.

92848567

8568 minLength: 1, maxLength: 255

8569

92858570 - `timezone: optional string or null`

92868571

92878572 IANA timezone identifier, e.g. "America/Los_Angeles".

92888573

8574 minLength: 1, maxLength: 255

8575

92898576### Beta Managed Agents Write Tool Config

92908577

9291- `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

8578- `BetaManagedAgentsWriteToolConfig object`

92928579

92938580 Configuration for the write tool.

92948581

from line 8583

92968583

92978584 - `name: "write"`

92988585

9299 - `"write"`

9300

93018586 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

93028587

93038588 Permission policy for tool execution.

93048589

9305 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8590 - `BetaManagedAgentsAlwaysAllowPolicy object`

93068591

93078592 Tool calls are automatically approved without user confirmation.

93088593

93098594 - `type: "always_allow"`

93108595

9311 - `"always_allow"`

9312

9313 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8596 - `BetaManagedAgentsAlwaysAskPolicy object`

93148597

93158598 Tool calls require user confirmation before execution.

93168599

93178600 - `type: "always_ask"`

93188601

9319 - `"always_ask"`

9320

93218602 - `type: "write"`

93228603

9323 - `"write"`

9324

93258604### Beta Managed Agents Write Tool Config Params

93268605

9327- `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`

8606- `BetaManagedAgentsWriteToolConfigParams object`

93288607

93298608 Configuration override for the write tool.

93308609

from line 8611

93328611

93338612 Must be "write".

93348613

9335 - `"write"`

9336

93378614 - `enabled: optional boolean or null`

93388615

93398616 Whether this tool is enabled and available to Claude. Overrides the default_config setting.

from line 8619

93428619

93438620 Permission policy for tool execution.

93448621

9345 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8622 - `BetaManagedAgentsAlwaysAllowPolicy object`

93468623

93478624 Tool calls are automatically approved without user confirmation.

93488625

93498626 - `type: "always_allow"`

93508627

9351 - `"always_allow"`

9352

9353 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8628 - `BetaManagedAgentsAlwaysAskPolicy object`

93548629

93558630 Tool calls require user confirmation before execution.

93568631

93578632 - `type: "always_ask"`

93588633

9359 - `"always_ask"`

9360

93618634 - `type: optional "write"`

93628635

9363 - `"write"`

9364

9365# Versions

9366

9367## List Agent Versions

9368

9369**get** `/v1/agents/{agent_id}/versions`

8636## Agents › Versions

8637

8638### List Agent Versions

8639

8640**GET** `/v1/agents/{agent_id}/versions`

93708641

93718642List Agent Versions

93728643

9373### Path Parameters

8644#### Path parameters

93748645

93758646- `agent_id: string`

93768647

9377### Query Parameters

8648#### Query parameters

93788649

93798650- `limit: optional number`

93808651

93818652 Maximum results per page. Default 20, maximum 100.

93828653

8654 format: int32

8655

93838656- `page: optional string`

93848657

93858658 Opaque pagination cursor.

93868659

9387### Header Parameters

8660#### Headers

93888661

93898662- `"anthropic-beta": optional array of AnthropicBeta`

93908663

from line 8735

94628735

94638736 - `"mid-conversation-tool-changes-2026-07-01"`

94648737

9465### Returns

8738#### Returns

94668739

94678740- `data: array of BetaManagedAgentsAgent`

94688741

from line 8747

94748747

94758748 A timestamp in RFC 3339 format

94768749

8750 format: date-time

8751

94778752 - `created_at: string`

94788753

94798754 A timestamp in RFC 3339 format

94808755

8756 format: date-time

8757

94818758 - `description: string or null`

94828759

94838760 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`

from line 8763

94868763

94878764 - `type: "url"`

94888765

9489 - `"url"`

9490

94918766 - `url: string`

94928767

94938768 - `metadata: map[string]`

from line 8841

95668841

95678842 How hard Claude works on each turn. Sets `output_config.effort` on every Messages call the session makes.

95688843

9569 - `BetaManagedAgentsEffortLow object { type }`

8844 - `BetaManagedAgentsEffortLow object`

95708845

95718846 Low effort. Favors latency over reasoning depth.

95728847

95738848 - `type: "low"`

95748849

9575 - `"low"`

9576

9577 - `BetaManagedAgentsEffortMedium object { type }`

8850 - `BetaManagedAgentsEffortMedium object`

95788851

95798852 Medium effort. Balances latency and reasoning depth.

95808853

95818854 - `type: "medium"`

95828855

9583 - `"medium"`

9584

9585 - `BetaManagedAgentsEffortHigh object { type }`

8856 - `BetaManagedAgentsEffortHigh object`

95868857

95878858 High effort. Favors reasoning depth.

95888859

95898860 - `type: "high"`

95908861

9591 - `"high"`

9592

9593 - `BetaManagedAgentsEffortXhigh object { type }`

8862 - `BetaManagedAgentsEffortXhigh object`

95948863

95958864 Extra-high effort. Not all models accept this level.

95968865

95978866 - `type: "xhigh"`

95988867

9599 - `"xhigh"`

9600

9601 - `BetaManagedAgentsEffortMax object { type }`

8868 - `BetaManagedAgentsEffortMax object`

96028869

96038870 Maximum effort. Favors reasoning depth over latency.

96048871

96058872 - `type: "max"`

96068873

9607 - `"max"`

9608

96098874 - `inference_geo: optional string`

96108875

96118876 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.

from line 8891

96268891

96278892 Agents the coordinator may spawn as session threads, each resolved to a specific version.

96288893

9629 - `BetaManagedAgentsAgentReference object { id, type, version }`

8894 - `BetaManagedAgentsAgentReference object`

96308895

96318896 A resolved agent reference with a concrete version.

96328897

from line 8899

96348899

96358900 - `type: "agent"`

96368901

9637 - `"agent"`

9638

96398902 - `version: number`

96408903

9641 - `BetaManagedAgentsAdvisor object { model, type }`

8904 format: int32

8905

8906 - `BetaManagedAgentsAdvisor object`

96428907

96438908 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.

96448909

from line 8913

96488913

96498914 - `type: "advisor"`

96508915

9651 - `"advisor"`

9652

96538916 - `type: "coordinator"`

96548917

9655 - `"coordinator"`

9656

96578918 - `name: string`

96588919

96598920 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`

96608921

9661 - `BetaManagedAgentsAnthropicSkill object { skill_id, type, version }`

8922 - `BetaManagedAgentsAnthropicSkill object`

96628923

96638924 A resolved Anthropic-managed skill.

96648925

from line 8927

96668927

96678928 - `type: "anthropic"`

96688929

9669 - `"anthropic"`

9670

96718930 - `version: string`

96728931

9673 - `BetaManagedAgentsCustomSkill object { skill_id, type, version }`

8932 - `BetaManagedAgentsCustomSkill object`

96748933

96758934 A resolved user-created custom skill.

96768935

from line 8937

96788937

96798938 - `type: "custom"`

96808939

9681 - `"custom"`

9682

96838940 - `version: string`

96848941

96858942 - `system: string or null`

96868943

96878944 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`

96888945

9689 - `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`

8946 - `BetaManagedAgentsAgentToolset20260401 object`

96908947

96918948 - `configs: array of BetaManagedAgentsAgentToolConfig`

96928949

9693 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`

8950 - `BetaManagedAgentsBashToolConfig object`

96948951

96958952 Configuration for the bash tool.

96968953

from line 8955

96988955

96998956 - `name: "bash"`

97008957

9701 - `"bash"`

9702

97038958 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

97048959

97058960 Permission policy for tool execution.

97068961

9707 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8962 - `BetaManagedAgentsAlwaysAllowPolicy object`

97088963

97098964 Tool calls are automatically approved without user confirmation.

97108965

97118966 - `type: "always_allow"`

97128967

9713 - `"always_allow"`

9714

9715 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8968 - `BetaManagedAgentsAlwaysAskPolicy object`

97168969

97178970 Tool calls require user confirmation before execution.

97188971

97198972 - `type: "always_ask"`

97208973

9721 - `"always_ask"`

9722

97238974 - `type: "bash"`

97248975

9725 - `"bash"`

9726

9727 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`

8976 - `BetaManagedAgentsEditToolConfig object`

97288977

97298978 Configuration for the edit tool.

97308979

from line 8981

97328981

97338982 - `name: "edit"`

97348983

9735 - `"edit"`

9736

97378984 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

97388985

97398986 Permission policy for tool execution.

97408987

9741 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

8988 - `BetaManagedAgentsAlwaysAllowPolicy object`

97428989

97438990 Tool calls are automatically approved without user confirmation.

97448991

9745 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

8992 - `BetaManagedAgentsAlwaysAskPolicy object`

97468993

97478994 Tool calls require user confirmation before execution.

97488995

97498996 - `type: "edit"`

97508997

9751 - `"edit"`

9752

9753 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`

8998 - `BetaManagedAgentsReadToolConfig object`

97548999

97559000 Configuration for the read tool.

97569001

from line 9003

97589003

97599004 - `name: "read"`

97609005

9761 - `"read"`

9762

97639006 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

97649007

97659008 Permission policy for tool execution.

97669009

9767 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9010 - `BetaManagedAgentsAlwaysAllowPolicy object`

97689011

97699012 Tool calls are automatically approved without user confirmation.

97709013

9771 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9014 - `BetaManagedAgentsAlwaysAskPolicy object`

97729015

97739016 Tool calls require user confirmation before execution.

97749017

97759018 - `type: "read"`

97769019

9777 - `"read"`

9778

9779 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`

9020 - `BetaManagedAgentsWriteToolConfig object`

97809021

97819022 Configuration for the write tool.

97829023

from line 9025

97849025

97859026 - `name: "write"`

97869027

9787 - `"write"`

9788

97899028 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

97909029

97919030 Permission policy for tool execution.

97929031

9793 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9032 - `BetaManagedAgentsAlwaysAllowPolicy object`

97949033

97959034 Tool calls are automatically approved without user confirmation.

97969035

9797 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9036 - `BetaManagedAgentsAlwaysAskPolicy object`

97989037

97999038 Tool calls require user confirmation before execution.

98009039

98019040 - `type: "write"`

98029041

9803 - `"write"`

9804

9805 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`

9042 - `BetaManagedAgentsGlobToolConfig object`

98069043

98079044 Configuration for the glob tool.

98089045

from line 9047

98109047

98119048 - `name: "glob"`

98129049

9813 - `"glob"`

9814

98159050 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

98169051

98179052 Permission policy for tool execution.

98189053

9819 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9054 - `BetaManagedAgentsAlwaysAllowPolicy object`

98209055

98219056 Tool calls are automatically approved without user confirmation.

98229057

9823 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9058 - `BetaManagedAgentsAlwaysAskPolicy object`

98249059

98259060 Tool calls require user confirmation before execution.

98269061

98279062 - `type: "glob"`

98289063

9829 - `"glob"`

9830

9831 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`

9064 - `BetaManagedAgentsGrepToolConfig object`

98329065

98339066 Configuration for the grep tool.

98349067

from line 9069

98369069

98379070 - `name: "grep"`

98389071

9839 - `"grep"`

9840

98419072 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

98429073

98439074 Permission policy for tool execution.

98449075

9845 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9076 - `BetaManagedAgentsAlwaysAllowPolicy object`

98469077

98479078 Tool calls are automatically approved without user confirmation.

98489079

9849 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9080 - `BetaManagedAgentsAlwaysAskPolicy object`

98509081

98519082 Tool calls require user confirmation before execution.

98529083

98539084 - `type: "grep"`

98549085

9855 - `"grep"`

9856

9857 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`

9086 - `BetaManagedAgentsWebFetchToolConfig object`

98589087

98599088 Configuration for the web_fetch tool.

98609089

from line 9091

98629091

98639092 - `name: "web_fetch"`

98649093

9865 - `"web_fetch"`

9866

98679094 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

98689095

98699096 Permission policy for tool execution.

98709097

9871 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9098 - `BetaManagedAgentsAlwaysAllowPolicy object`

98729099

98739100 Tool calls are automatically approved without user confirmation.

98749101

9875 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9102 - `BetaManagedAgentsAlwaysAskPolicy object`

98769103

98779104 Tool calls require user confirmation before execution.

98789105

98799106 - `type: "web_fetch"`

98809107

9881 - `"web_fetch"`

9882

98839108 - `allowed_domains: optional array of string`

98849109

98859110 - `blocked_domains: optional array of string`

98869111

98879112 - `max_content_tokens: optional number or null`

98889113

9889 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`

9114 format: int32

9115

9116 - `BetaManagedAgentsWebSearchToolConfig object`

98909117

98919118 Configuration for the web_search tool.

98929119

from line 9121

98949121

98959122 - `name: "web_search"`

98969123

9897 - `"web_search"`

9898

98999124 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`

99009125

99019126 Permission policy for tool execution.

99029127

9903 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9128 - `BetaManagedAgentsAlwaysAllowPolicy object`

99049129

99059130 Tool calls are automatically approved without user confirmation.

99069131

9907 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9132 - `BetaManagedAgentsAlwaysAskPolicy object`

99089133

99099134 Tool calls require user confirmation before execution.

99109135

99119136 - `type: "web_search"`

99129137

9913 - `"web_search"`

9914

99159138 - `allowed_domains: optional array of string`

99169139

99179140 - `blocked_domains: optional array of string`

from line 9147

99249147

99259148 Location precision. Only "approximate" is supported.

99269149

9927 - `"approximate"`

9928

99299150 - `city: optional string or null`

99309151

99319152 City name.

99329153

9154 minLength: 1, maxLength: 255

9155

99339156 - `country: optional string or null`

99349157

99359158 Two-letter ISO 3166-1 country code, uppercase.

from line 9161

99389161

99399162 Region or state name.

99409163

9164 minLength: 1, maxLength: 255

9165

99419166 - `timezone: optional string or null`

99429167

99439168 IANA timezone identifier, e.g. "America/Los_Angeles".

99449169

9170 minLength: 1, maxLength: 255

9171

99459172 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`

99469173

99479174 Resolved default configuration for agent tools.

from line 9179

99529179

99539180 Permission policy for tool execution.

99549181

9955 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9182 - `BetaManagedAgentsAlwaysAllowPolicy object`

99569183

99579184 Tool calls are automatically approved without user confirmation.

99589185

9959 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9186 - `BetaManagedAgentsAlwaysAskPolicy object`

99609187

99619188 Tool calls require user confirmation before execution.

99629189

99639190 - `type: "agent_toolset_20260401"`

99649191

9965 - `"agent_toolset_20260401"`

9966

9967 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`

9192 - `BetaManagedAgentsMCPToolset object`

99689193

99699194 - `configs: array of BetaManagedAgentsMCPToolConfig`

99709195

from line 9201

99769201

99779202 Permission policy for tool execution.

99789203

9979 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9204 - `BetaManagedAgentsAlwaysAllowPolicy object`

99809205

99819206 Tool calls are automatically approved without user confirmation.

99829207

9983 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9208 - `BetaManagedAgentsAlwaysAskPolicy object`

99849209

99859210 Tool calls require user confirmation before execution.

99869211

from line 9219

99949219

99959220 Permission policy for tool execution.

99969221

9997 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`

9222 - `BetaManagedAgentsAlwaysAllowPolicy object`

99989223

99999224 Tool calls are automatically approved without user confirmation.

100009225

10001 - `BetaManagedAgentsAlwaysAskPolicy object { type }`

9226 - `BetaManagedAgentsAlwaysAskPolicy object`

100029227

100039228 Tool calls require user confirmation before execution.

100049229

from line 9231

100069231

100079232 - `type: "mcp_toolset"`

100089233

10009 - `"mcp_toolset"`

10010

10011 - `BetaManagedAgentsCustomTool object { description, input_schema, name, type }`

9234 - `BetaManagedAgentsCustomTool object`

100129235

100139236 A custom tool as returned in API responses.

100149237

from line 9243

100209243

100219244 - `type: "object"`

100229245

10023 - `"object"`

10024

100259246 - `properties: optional map[unknown] or null`

100269247

100279248 - `required: optional array of string or null`

from line 9251

100309251

100319252 - `type: "custom"`

100329253

10033 - `"custom"`

10034

100359254 - `type: "agent"`

100369255

10037 - `"agent"`

10038

100399256 - `updated_at: string`

100409257

100419258 A timestamp in RFC 3339 format

100429259

9260 format: date-time

9261

100439262 - `version: number`

100449263

100459264 The agent's current version. Starts at 1 and increments when the agent is modified.

100469265

9266 format: int32

9267

100479268- `next_page: optional string or null`

100489269

100499270 Opaque cursor for the next page. Null when no more results.

100509271

10051### Example

10052

10053```http

9272#### Example

9273

9274```bash

100549275curl https://api.anthropic.com/v1/agents/$AGENT_ID/versions \

100559276 -H 'anthropic-version: 2023-06-01' \

100569277 -H 'anthropic-beta: managed-agents-2026-04-01' \

100579278 -H "X-Api-Key: $ANTHROPIC_API_KEY"

100589279```

100599280

10060#### Response

9281##### Response (200)

100619282

100629283```json

100639284{

100649285

This page’s history 25 edits

22 Oct 2026 +12 −12
21 Oct 2026 +12 −0
16 Oct 2026 +30 −6
14 Oct 2026 +322 −0
12 Oct 2026 +9 −9
12 Oct 2026 +4 −4

The page’s own history →

Where it came from

The captureapi
Upstream pageplatform.claude.com

Around it

Every changethe ledger
That day25 Aug 2026