---
title: "Changes to Archive Agent"
method: POST
path: "/v1/agents/{agent_id}/archive?beta=true"
---

# Changes to Archive Agent

`POST /v1/agents/{agent_id}/archive?beta=true`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 34 of 287 revisions.

- **2026-11-09** `d53195e9d075`: 1 info
- **2026-11-05** `037a593978dc`: 1 info
- **2026-11-02** `9578ce4001dd`: 1 info
- **2026-10-23** `f538a797852c`: 1 info
- **2026-10-23** `8071e43a8476`: 1 info
- **2026-10-22** `376dea998624`: 1 info
- **2026-10-21** `94c83daca660`: 78 info
- **2026-10-21** `b6f3fef9c0b5`: 1 info
- **2026-10-14** `e6a88013f0b2`: 1 info
- **2026-10-14** `938736033e4b`: 1 info
- **2026-10-09** `ee978b5e1294`: 2 info
- **2026-10-09** `166bdc0ad612`: 1 breaking, 1 info
- **2026-10-07** `2705c258c5dc`: 1 info
- **2026-10-07** `d619b4669a3e`: 1 info
- **2026-09-30** `d721a6487a16`: 3 info
- **2026-09-30** `ab91b3e513b5`: 1 info
- **2026-09-28** `3cd29369f196`: 2 info
- **2026-09-22** `257523f5aeb5`: 3 info
- **2026-09-18** `3144b1e8c9e4`: 1 breaking, 1 warning
- **2026-09-10** `96aef986008e`: 11 breaking, 11 info
- **2026-09-04** `4789294140a2`: 1 info
- **2026-09-01** `d1d189d791d1`: 1 info
- **2026-08-19** `0042750ea1ee`: 4 breaking, 1 info
- **2026-08-19** `d2b230555b7f`: 2 breaking, 4 info
- **2026-08-07** `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, 5 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-11-09** `d53195e9d075`: 1 info
  - added `subschema #1` to the `model/id` response property `anyOf` list for the response status `200`
- **2026-11-05** `037a593978dc`: 1 info
  - added the enum value `admin-user-sign-out-2026-10-08` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-11-02** `9578ce4001dd`: 1 info
  - the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWebSearchToolConfig]/user_location/anyOf[#/components/schemas/BetaManagedAgentsUserLocation]/country/anyOf[subschema #1]/` response's property pattern `^[A-Z]{2}$` was added for the status `200`
- **2026-10-23** `f538a797852c`: 1 info
  - added the enum value `experimental-claude-tag-2026-10-21` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-10-23** `8071e43a8476`: 1 info
  - added the enum value `analytics-usage-cost-2026-08-24` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-10-22** `376dea998624`: 1 info
  - added the enum value `message-threads-2026-08-12` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-10-21** `94c83daca660`: 78 info
  - the `type` response property const value `advisor` was added for the status `200`
  - the `type` response property const value `agent` was added for the status `200`
  - the `type` response property const value `agent` was added for the status `200`
  - the `type` response property const value `agent` was added for the status `200`
  - the `type` response property const value `agent` was added for the status `200`
  - the `type` response property const value `agent_toolset_20260401` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_allow` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `always_ask` was added for the status `200`
  - the `type` response property const value `anthropic` was added for the status `200`
  - the `type` response property const value `coordinator` was added for the status `200`
  - the `type` response property const value `custom` was added for the status `200`
  - the `type` response property const value `custom` was added for the status `200`
  - the `type` response property const value `high` was added for the status `200`
  - the `type` response property const value `low` was added for the status `200`
  - the `type` response property const value `max` was added for the status `200`
  - the `type` response property const value `mcp_toolset` was added for the status `200`
  - the `type` response property const value `medium` was added for the status `200`
  - the `type` response property const value `url` was added for the status `200`
  - the `type` response property const value `xhigh` was added for the status `200`
  - removed the `advisor` enum value from the `multiagent/anyOf[#/components/schemas/BetaManagedAgentsMultiagent]/oneOf[#/components/schemas/BetaManagedAgentsMultiagentCoordinator]/agents/items/oneOf[#/components/schemas/BetaManagedAgentsAdvisor]/type` response property for the response status `200`
  - …38 more
- **2026-10-21** `b6f3fef9c0b5`: 1 info
  - added the enum value `webhooks-2026-10-07` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-10-14** `e6a88013f0b2`: 1 info
  - added the enum value `telemetry-destinations-2026-08-11` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-10-14** `938736033e4b`: 1 info
  - added the required property `execution_identity` to the response with the `200` status
- **2026-10-09** `ee978b5e1294`: 2 info
  - added `subschema #12, subschema #13` to the `model/id` response property `anyOf` list for the response status `200`
  - removed `subschema #12, subschema #13` from the `model/id` response property `anyOf` list for the response status `200`
- **2026-10-09** `166bdc0ad612`: 1 breaking, 1 info
  - added `#/components/schemas/BetaManagedAgentsMultiagent20261001` to the `multiagent/anyOf[#/components/schemas/BetaManagedAgentsMultiagent]/` response property `oneOf` list for the response status `200`
  - added `multiagent_20261001` discriminator mapping keys to the `multiagent/anyOf[#/components/schemas/BetaManagedAgentsMultiagent]/` response property for the response status `200`
- **2026-10-07** `2705c258c5dc`: 1 info
  - added `subschema #1` to the `model/id` response property `anyOf` list for the response status `200`
- **2026-10-07** `d619b4669a3e`: 1 info
  - added the required property `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWebFetchToolConfig]/url_sources` to the response with the `200` status
- **2026-09-30** `d721a6487a16`: 3 info
  - added the enum value `spend-limit-reads-2026-09-26` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
  - added `subschema #15, subschema #16` to the `model/id` response property `anyOf` list for the response status `200`
  - removed `subschema #15, subschema #16` from the `model/id` response property `anyOf` list for the response status `200`
- **2026-09-30** `ab91b3e513b5`: 1 info
  - added the enum value `ce-plugins-2026-09-01` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
- **2026-09-28** `3cd29369f196`: 2 info
  - added `subschema #1, subschema #4` to the `model/id` response property `anyOf` list for the response status `200`
  - removed `subschema #3` from the `model/id` response property `anyOf` list for the response status `200`
- **2026-09-22** `257523f5aeb5`: 3 info
  - added the enum value `inline-tools-2026-09-15` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
  - added the enum value `mcp-client-2026-09-15` to the property `items/anyOf[subschema #2]/` of the `header` request parameter `anthropic-beta`
  - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200`
- **2026-09-18** `3144b1e8c9e4`: 1 breaking, 1 warning
  - for the `header` request parameter `anthropic-beta`, the type changed from `string` to `array`
  - for the `header` request parameter `anthropic-beta`, the type of property `items/` changed from `string` to no type
- **2026-09-10** `96aef986008e`: 11 breaking, 11 info
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsBashToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsEditToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsGlobToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsGrepToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsReadToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWebFetchToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWebSearchToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWriteToolConfig]/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/default_config/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolset]/configs/items/permission_policy` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsAutoPolicy` to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolset]/default_config/permission_policy` response property `oneOf` list for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsBashToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsEditToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsGlobToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsGrepToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsReadToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWebFetchToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWebSearchToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/oneOf[#/components/schemas/BetaManagedAgentsWriteToolConfig]/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/default_config/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolset]/configs/items/permission_policy` response property for the response status `200`
  - added `auto` discriminator mapping keys to the `tools/items/oneOf[#/components/schemas/BetaManagedAgentsMCPToolset]/default_config/permission_policy` response property for the response status `200`
- **2026-09-04** `4789294140a2`: 1 info
  - added the new optional `header` request parameter `anthropic-workspace-id`
- **2026-09-01** `d1d189d791d1`: 1 info
  - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200`
- **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 `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
  - added discriminator to `tools/items/oneOf[#/components/schemas/BetaManagedAgentsAgentToolset20260401]/configs/items/` response property for the response status `200`
- **2026-08-19** `d2b230555b7f`: 2 breaking, 4 info
  - 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/BetaManagedAgentsMultiagent` from the `multiagent` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BetaTimestamp` from the `archived_at` response property `allOf` list for the response status `200`
  - added `#/components/schemas/BetaManagedAgentsMultiagent, subschema #2` to the `multiagent` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/BetaTimestamp, subschema #2` to the `archived_at` response property `anyOf` list for the response status `200`
- **2026-08-07** `93d8fd7d6493`: 5 breaking, 2 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 changed from `object` to no type 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 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 info
  - 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`: 1 info
  - added the optional property `model/effort` to the response with the `200` status
- **2026-06-30** `7caa9a75ddbc`: 1 info
  - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200`
- **2026-06-09** `00259327305f`: 1 info
  - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200`
- **2026-06-06** `546c704d347b`: 1 breaking, 5 info
  - 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/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`: 1 info
  - added `subschema #2` to the `model/id` response property `anyOf` list for the response status `200`
- **2026-05-06** `a4186730f56c`: 1 info
  - added the required property `multiagent` to the response with the `200` status
- **2026-04-16** `e0696f59ae07`: 1 info
  - 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/:agent_id/archive%3Fbeta=true/post.md) - [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) - [Page](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/agents/:agent_id/archive%3Fbeta=true/post)
