---
title: "Changes to List Agents"
method: GET
path: "/v1/agents?beta=true"
---

# Changes to List Agents

`GET /v1/agents?beta=true`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 12 of 67 revisions.

- **2026-08-19** `0042750ea1ee` — 4 breaking, 1 info
- **2026-08-17** `d2b230555b7f` — 3 breaking, 4 info
- **2026-08-06** `93d8fd7d6493` — 5 breaking, 2 info
- **2026-07-24** `a97790bd7f18` — 2 info
- **2026-07-22** `5e4a8830793b` — 1 info
- **2026-06-30** `7caa9a75ddbc` — 1 info
- **2026-06-09** `00259327305f` — 1 info
- **2026-06-06** `546c704d347b` — 1 breaking, 6 info
- **2026-05-28** `f9d488f9290d` — 1 info
- **2026-05-06** `a4186730f56c` — 1 info
- **2026-04-16** `e0696f59ae07` — 1 info
- **2026-04-08** `69486316563e` — 1 info

## Changes

- **2026-08-19** `0042750ea1ee` — 4 breaking, 1 info
  - added `#/components/schemas/BetaManagedAgentsBashToolConfig, #/components/schemas/BetaManagedAgentsEditToolConfig, #/components/schemas/BetaManagedAgentsReadToolConfig, #/components/schemas/BetaManagedAgentsWriteToolConfig, #/components/schemas/BetaManagedAgentsGlobToolConfig, #/components/schemas/BetaManagedAgentsGrepToolConfig, #/components/schemas/BetaManagedAgentsWebFetchToolConfig, #/components/schemas/BetaManagedAgentsWebSearchToolConfig` to the `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/` response property `oneOf` list for the response status `200`
  - removed the required property `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/enabled` from the response with the `200` status
  - removed the required property `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/name` from the response with the `200` status
  - removed the required property `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/permission_policy` from the response with the `200` status
  - added discriminator to `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/` response property for the response status `200`
- **2026-08-17** `d2b230555b7f` — 3 breaking, 4 info
  - response property `data/items/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/system` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `next_page` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed `#/components/schemas/BetaManagedAgentsMultiagent` from the `data/items/multiagent` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BetaTimestamp` from the `data/items/archived_at` response property `allOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsMultiagent, subschema #2` to the `data/items/multiagent` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/BetaTimestamp, subschema #2` to the `data/items/archived_at` response property `anyOf` list for the response status `200`
- **2026-08-06** `93d8fd7d6493` — 5 breaking, 2 info
  - added `#/components/schemas/BetaManagedAgentsAgentReference, #/components/schemas/BetaManagedAgentsAdvisor` to the `data/items/multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/` response property `oneOf` list for the response status `200`
  - the `data/items/multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `data/items/multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/id` from the response with the `200` status
  - removed the required property `data/items/multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/type` from the response with the `200` status
  - removed the required property `data/items/multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/version` from the response with the `200` status
  - added the optional property `data/items/model/inference_geo` to the response with the `200` status
  - added discriminator to `data/items/multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/` response property for the response status `200`
- **2026-07-24** `a97790bd7f18` — 2 info
  - added `subschema #4, subschema #5, subschema #6, subschema #7, subschema #11, subschema #12` to the `data/items/model/id` response property `anyOf` list for the response status `200`
  - removed `subschema #4, subschema #5, subschema #6, subschema #10, subschema #11` from the `data/items/model/id` response property `anyOf` list for the response status `200`
- **2026-07-22** `5e4a8830793b` — 1 info
  - added the optional property `data/items/model/effort` to the response with the `200` status
- **2026-06-30** `7caa9a75ddbc` — 1 info
  - added `subschema #2` to the `data/items/model/id` response property `anyOf` list for the response status `200`
- **2026-06-09** `00259327305f` — 1 info
  - added `subschema #2` to the `data/items/model/id` response property `anyOf` list for the response status `200`
- **2026-06-06** `546c704d347b` — 1 breaking, 6 info
  - response property `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/required` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed `#/components/schemas/BetaManagedAgentsStruct` from the `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/properties` response property `allOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/properties` response property `anyOf` list for the response status `200`
  - the response property `data` became required for the status `200`
  - the response property `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/type` became required for the status `200`
  - the `type` response property const value `object` was added for the status `200`
  - removed the `object` enum value from the `data/items/tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/type` response property for the response status `200`
- **2026-05-28** `f9d488f9290d` — 1 info
  - added `subschema #2` to the `data/items/model/id` response property `anyOf` list for the response status `200`
- **2026-05-06** `a4186730f56c` — 1 info
  - added the required property `data/items/multiagent` to the response with the `200` status
- **2026-04-16** `e0696f59ae07` — 1 info
  - added `subschema #2` to the `data/items/model/id` response property `anyOf` list for the response status `200`
- **2026-04-08** `69486316563e` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/anthropics/apis/anthropic-api/docs/v1/agents?beta=true/get.md) · [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [Page](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/agents?beta=true/get)