--- title: "Changes to Create Agent" method: POST path: "/v1/agents?beta=true" --- # Changes to Create Agent `POST /v1/agents?beta=true` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 13 of 67 revisions. - **2026-08-19** `0042750ea1ee` — 4 breaking, 3 warning, 3 info - **2026-08-17** `d2b230555b7f` — 16 breaking, 7 warning, 20 info - **2026-08-06** `93d8fd7d6493` — 5 breaking, 5 info - **2026-07-24** `a97790bd7f18` — 2 breaking, 4 info - **2026-07-22** `5e4a8830793b` — 2 info - **2026-07-02** `ec00b28b50c2` — 1 info - **2026-06-30** `7caa9a75ddbc` — 3 info - **2026-06-09** `00259327305f` — 3 info - **2026-06-06** `546c704d347b` — 5 breaking, 1 warning, 7 info - **2026-05-28** `f9d488f9290d` — 3 info - **2026-05-06** `a4186730f56c` — 2 info - **2026-04-16** `e0696f59ae07` — 3 info - **2026-04-08** `69486316563e` — 1 info ## Changes - **2026-08-19** `0042750ea1ee` — 4 breaking, 3 warning, 3 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 `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/` response property `oneOf` list for the response status `200` - removed the required property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/enabled` from the response with the `200` status - removed the required property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/name` from the response with the `200` status - removed the required property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/permission_policy` from the response with the `200` status - removed the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/enabled` - removed the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/name` - removed the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy` - added discriminator to `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/` request property - added `#/components/schemas/BetaManagedAgentsBashToolConfigParams, #/components/schemas/BetaManagedAgentsEditToolConfigParams, #/components/schemas/BetaManagedAgentsReadToolConfigParams, #/components/schemas/BetaManagedAgentsWriteToolConfigParams, #/components/schemas/BetaManagedAgentsGlobToolConfigParams, #/components/schemas/BetaManagedAgentsGrepToolConfigParams, #/components/schemas/BetaManagedAgentsWebFetchToolConfigParams, #/components/schemas/BetaManagedAgentsWebSearchToolConfigParams` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/` request property `oneOf` list - added discriminator to `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/` response property for the response status `200` - **2026-08-17** `d2b230555b7f` — 16 breaking, 7 warning, 20 info - the request property `description` became not nullable - the request property `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/effort` became not nullable - the request property `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/inference_geo` became not nullable - the request property `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/speed` became not nullable - the request property `multiagent` became not nullable - the request property `skills/items/oneOf[#/components/schemas/BetaManagedAgentsAnthropicSkillParams]/version` became not nullable - the request property `skills/items/oneOf[#/components/schemas/BetaManagedAgentsCustomSkillParams]/version` became not nullable - the request property `system` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/enabled` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/default_config` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/configs/items/enabled` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/configs/items/permission_policy` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/default_config` became not nullable - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `system` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - removed `#/components/schemas/BetaManagedAgentsAgentToolsetDefaultConfigParams` from the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/default_config` request property `allOf` list - removed `#/components/schemas/BetaManagedAgentsEffortParams` from the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/effort` request property `allOf` list - removed `#/components/schemas/BetaManagedAgentsMCPToolsetDefaultConfigParams` from the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/default_config` request property `allOf` list - removed `#/components/schemas/BetaManagedAgentsMultiagentParams` from the `multiagent` request property `allOf` list - removed `#/components/schemas/BetaManagedAgentsPermissionPolicy` from the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy` request property `allOf` list - removed `#/components/schemas/BetaManagedAgentsPermissionPolicy` from the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/configs/items/permission_policy` request property `allOf` list - removed `#/components/schemas/BetaManagedAgentsSpeed` from the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/speed` request property `allOf` list - added `#/components/schemas/BetaManagedAgentsAgentToolsetDefaultConfigParams, subschema #2` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/default_config` request property `anyOf` list - added `#/components/schemas/BetaManagedAgentsEffortParams, subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/effort` request property `anyOf` list - added `#/components/schemas/BetaManagedAgentsMCPToolsetDefaultConfigParams, subschema #2` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/default_config` request property `anyOf` list - added `#/components/schemas/BetaManagedAgentsMultiagentParams, subschema #2` to the `multiagent` request property `anyOf` list - added `#/components/schemas/BetaManagedAgentsPermissionPolicy, subschema #2` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/permission_policy` request property `anyOf` list - added `#/components/schemas/BetaManagedAgentsPermissionPolicy, subschema #2` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/configs/items/permission_policy` request property `anyOf` list - added `#/components/schemas/BetaManagedAgentsSpeed, subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/speed` request property `anyOf` list - request property `description` list-of-types was widened by adding types `null` to media type `application/json` - request property `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/inference_geo` list-of-types was widened by adding types `null` to media type `application/json` - request property `skills/items/oneOf[#/components/schemas/BetaManagedAgentsAnthropicSkillParams]/version` list-of-types was widened by adding types `null` to media type `application/json` - request property `skills/items/oneOf[#/components/schemas/BetaManagedAgentsCustomSkillParams]/version` list-of-types was widened by adding types `null` to media type `application/json` - request property `system` list-of-types was widened by adding types `null` to media type `application/json` - request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401Params]/configs/items/enabled` list-of-types was widened by adding types `null` to media type `application/json` - request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolsetParams]/configs/items/enabled` list-of-types was widened by adding types `null` to media type `application/json` - the `skills/items/oneOf[#/components/schemas/BetaManagedAgentsAnthropicSkillParams]/version` request property's minLength was decreased from `1` to `0` - the `skills/items/oneOf[#/components/schemas/BetaManagedAgentsCustomSkillParams]/version` request property's minLength was decreased from `1` to `0` - removed `#/components/schemas/BetaManagedAgentsMultiagent` from the `multiagent` response property `allOf` list for the response status `200` - …3 more - **2026-08-06** `93d8fd7d6493` — 5 breaking, 5 info - added `#/components/schemas/BetaManagedAgentsAgentReference, #/components/schemas/BetaManagedAgentsAdvisor` to the `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/` response property `oneOf` list for the response status `200` - the `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 `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/id` from the response with the `200` status - removed the required property `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/type` from the response with the `200` status - removed the required property `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/version` from the response with the `200` status - added the new optional request property `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/inference_geo` - added `advisor` discriminator mapping keys to the `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagentParams]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinatorParams]/agents/items/oneOf[subschema #2]/` request property - added `#/components/schemas/BetaManagedAgentsAdvisorParams` to the `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagentParams]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinatorParams]/agents/items/oneOf[subschema #2]/` request property `oneOf` list - added the optional property `model/inference_geo` to the response with the `200` status - added discriminator to `multiagent/allOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/` response property for the response status `200` - **2026-07-24** `a97790bd7f18` — 2 breaking, 4 info - removed `subschema #4, subschema #5, subschema #6, subschema #10, subschema #11` from the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/id` request property `anyOf` list - removed `subschema #4, subschema #5, subschema #6, subschema #10, subschema #11` from the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/` request property `anyOf` list - added `subschema #4, subschema #5, subschema #6, subschema #7, subschema #11, subschema #12` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/id` request property `anyOf` list - added `subschema #4, subschema #5, subschema #6, subschema #7, subschema #11, subschema #12` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/` request property `anyOf` list - added `subschema #4, subschema #5, subschema #6, subschema #7, subschema #11, subschema #12` to the `model/id` response property `anyOf` list for the response status `200` - removed `subschema #4, subschema #5, subschema #6, subschema #10, subschema #11` from the `model/id` response property `anyOf` list for the response status `200` - **2026-07-22** `5e4a8830793b` — 2 info - added the new optional request property `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/effort` - added the optional property `model/effort` to the response with the `200` status - **2026-07-02** `ec00b28b50c2` — 1 info - the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/description` request property's maxLength was increased from `1024` to `4096` - **2026-06-30** `7caa9a75ddbc` — 3 info - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/id` request property `anyOf` list - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/` request property `anyOf` list - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200` - **2026-06-09** `00259327305f` — 3 info - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/id` request property `anyOf` list - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/` request property `anyOf` list - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200` - **2026-06-06** `546c704d347b` — 5 breaking, 1 warning, 7 info - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/input_schema/allOf[#/components/schemas/BetaManagedAgentsCustomToolInputSchema]/properties` became not nullable - the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/input_schema/allOf[#/components/schemas/BetaManagedAgentsCustomToolInputSchema]/type` became required - the `type` request property const value `object` was added - removed the enum value `object` of the request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/input_schema/allOf[#/components/schemas/BetaManagedAgentsCustomToolInputSchema]/type` - response property `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 `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/input_schema/allOf[#/components/schemas/BetaManagedAgentsCustomToolInputSchema]/properties` request property `allOf` list - added `subschema #1, subschema #2` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/input_schema/allOf[#/components/schemas/BetaManagedAgentsCustomToolInputSchema]/properties` request property `anyOf` list - request property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomToolParams]/input_schema/allOf[#/components/schemas/BetaManagedAgentsCustomToolInputSchema]/required` list-of-types was widened by adding types `null` to media type `application/json` - removed `#/components/schemas/BetaManagedAgentsStruct` from the `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 `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/properties` response property `anyOf` list for the response status `200` - the response property `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 `tools/items/oneOf[#/components/schemas/BetaManagedAgentsCustomTool]/input_schema/type` response property for the response status `200` - **2026-05-28** `f9d488f9290d` — 3 info - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/id` request property `anyOf` list - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/` request property `anyOf` list - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200` - **2026-05-06** `a4186730f56c` — 2 info - added the new optional request property `multiagent` - added the required property `multiagent` to the response with the `200` status - **2026-04-16** `e0696f59ae07` — 3 info - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[#/components/schemas/BetaManagedAgentsModelConfigParams]/id` request property `anyOf` list - added `subschema #2` to the `model/allOf[#/components/schemas/BetaManagedAgentsModelParams]/oneOf[subschema #1: BetaManagedAgentsModel]/allOf[subschema #1: BetaManagedAgentsModel]/` request property `anyOf` list - added `subschema #2` to the `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/post.md) · [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [Page](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/agents?beta=true/post)