---
title: "Changes to Update a Credential"
method: POST
path: "/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true"
---

# Changes to Update a Credential

`POST /v1/vaults/{vault_id}/credentials/{credential_id}?beta=true`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 19 of 287 revisions.

- **2026-11-05** `037a593978dc`: 1 info
- **2026-11-02** `9578ce4001dd`: 3 breaking
- **2026-10-23** `f538a797852c`: 1 info
- **2026-10-23** `8071e43a8476`: 1 info
- **2026-10-22** `376dea998624`: 1 info
- **2026-10-21** `94c83daca660`: 14 breaking, 18 info
- **2026-10-21** `b6f3fef9c0b5`: 1 info
- **2026-10-14** `e6a88013f0b2`: 1 info
- **2026-09-30** `d721a6487a16`: 1 info
- **2026-09-30** `ab91b3e513b5`: 1 info
- **2026-09-22** `257523f5aeb5`: 2 info
- **2026-09-18** `3144b1e8c9e4`: 1 breaking, 1 warning
- **2026-09-04** `1bb7c7a0a4a9`: 1 info
- **2026-09-04** `4789294140a2`: 1 info
- **2026-08-19** `d2b230555b7f`: 11 breaking, 2 warning, 17 info
- **2026-06-30** `26335fd8487a`: 2 info
- **2026-06-09** `2336fecb081b`: 1 breaking, 3 info
- **2026-04-16** `e0696f59ae07`: 1 info
- **2026-04-08** `69486316563e`: 1 info

## Changes

- **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`: 3 breaking
  - added the pattern `^[^\x00-\x1f\x7f]*$` to the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/secret_value/anyOf[subschema #1]/`
  - added the pattern `^[^\x00-\x1f\x7f]*$` to the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/access_token/anyOf[subschema #1]/`
  - added the pattern `^[^\x00-\x1f\x7f]*$` to the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsStaticBearerUpdateParams]/token/anyOf[subschema #1]/`
- **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`: 14 breaking, 18 info
  - the `type` request property const value `client_secret_basic` was added
  - the `type` request property const value `client_secret_post` was added
  - the `type` request property const value `environment_variable` was added
  - the `type` request property const value `limited` was added
  - the `type` request property const value `mcp_oauth` was added
  - the `type` request property const value `static_bearer` was added
  - the `type` request property const value `unrestricted` was added
  - removed the enum value `client_secret_basic` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh/anyOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshUpdateParams]/token_endpoint_auth/oneOf[#/components/schemas/BetaManagedAgentsTokenEndpointAuthBasicUpdateParam]/type`
  - removed the enum value `client_secret_post` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh/anyOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshUpdateParams]/token_endpoint_auth/oneOf[#/components/schemas/BetaManagedAgentsTokenEndpointAuthPostUpdateParam]/type`
  - removed the enum value `environment_variable` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/type`
  - removed the enum value `limited` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/networking/anyOf[#/components/schemas/BetaManagedAgentsCredentialNetworkingParams]/oneOf[#/components/schemas/BetaManagedAgentsLimitedCredentialNetworkingParams]/type`
  - removed the enum value `mcp_oauth` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/type`
  - removed the enum value `static_bearer` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsStaticBearerUpdateParams]/type`
  - removed the enum value `unrestricted` of the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/networking/anyOf[#/components/schemas/BetaManagedAgentsCredentialNetworkingParams]/oneOf[#/components/schemas/BetaManagedAgentsUnrestrictedCredentialNetworkingParams]/type`
  - the `type` response property const value `client_secret_basic` was added for the status `200`
  - the `type` response property const value `client_secret_post` was added for the status `200`
  - the `type` response property const value `environment_variable` was added for the status `200`
  - the `type` response property const value `limited` was added for the status `200`
  - the `type` response property const value `mcp_oauth` was added for the status `200`
  - the `type` response property const value `none` was added for the status `200`
  - the `type` response property const value `static_bearer` was added for the status `200`
  - the `type` response property const value `unrestricted` was added for the status `200`
  - the `type` response property const value `vault_credential` was added for the status `200`
  - removed the `client_secret_basic` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/refresh/anyOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshResponse]/token_endpoint_auth/oneOf[#/components/schemas/BetaManagedAgentsTokenEndpointAuthBasicResponse]/type` response property for the response status `200`
  - removed the `client_secret_post` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/refresh/anyOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshResponse]/token_endpoint_auth/oneOf[#/components/schemas/BetaManagedAgentsTokenEndpointAuthPostResponse]/type` response property for the response status `200`
  - removed the `environment_variable` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableAuthResponse]/type` response property for the response status `200`
  - removed the `limited` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableAuthResponse]/networking/allOf[#/components/schemas/BetaManagedAgentsCredentialNetworkingResponse]/oneOf[#/components/schemas/BetaManagedAgentsLimitedCredentialNetworkingResponse]/type` response property for the response status `200`
  - removed the `mcp_oauth` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/type` response property for the response status `200`
  - removed the `none` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/refresh/anyOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshResponse]/token_endpoint_auth/oneOf[#/components/schemas/BetaManagedAgentsTokenEndpointAuthNoneResponse]/type` response property for the response status `200`
  - removed the `static_bearer` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsStaticBearerAuthResponse]/type` response property for the response status `200`
  - removed the `unrestricted` enum value from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableAuthResponse]/networking/allOf[#/components/schemas/BetaManagedAgentsCredentialNetworkingResponse]/oneOf[#/components/schemas/BetaManagedAgentsUnrestrictedCredentialNetworkingResponse]/type` response property for the response status `200`
  - removed the `vault_credential` enum value from the `type` response property for the response status `200`
- **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-09-30** `d721a6487a16`: 1 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`
- **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-22** `257523f5aeb5`: 2 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`
- **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-04** `1bb7c7a0a4a9`: 1 info
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh/anyOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshUpdateParams]/refresh_token/anyOf[subschema #1]/` request property's maxLength was increased from `4096` to `8192`
- **2026-09-04** `4789294140a2`: 1 info
  - added the new optional `header` request parameter `anthropic-workspace-id`
- **2026-08-19** `d2b230555b7f`: 11 breaking, 2 warning, 17 info
  - the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/networking` became not nullable
  - the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/secret_value` became not nullable
  - the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/access_token` became not nullable
  - the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/expires_at` became not nullable
  - the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh` became not nullable
  - the request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsStaticBearerUpdateParams]/token` became not nullable
  - the request property `display_name` became not nullable
  - the request property `metadata` became not nullable
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/expires_at` request property type changed from `string` to no type, and format from `date-time` to no format
  - response property `display_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/expires_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - removed `#/components/schemas/BetaManagedAgentsCredentialNetworkingParams` from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/networking` request property `allOf` list
  - removed `#/components/schemas/BetaManagedAgentsMcpOauthRefreshUpdateParams` from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh` request property `allOf` list
  - added `#/components/schemas/BetaManagedAgentsCredentialNetworkingParams, subschema #2` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/networking` request property `anyOf` list
  - added `#/components/schemas/BetaManagedAgentsMcpOauthRefreshUpdateParams, subschema #2` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh` request property `anyOf` list
  - added `#/components/schemas/BetaTimestamp, subschema #2` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/expires_at` request property `anyOf` list
  - request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/secret_value` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/access_token` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsStaticBearerUpdateParams]/token` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `display_name` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `metadata` list-of-types was widened by adding types `null` to media type `application/json`
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/secret_value` request property's minLength was decreased from `1` to `0`
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/access_token` request property's minLength was decreased from `1` to `0`
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsStaticBearerUpdateParams]/token` request property's minLength was decreased from `1` to `0`
  - the `display_name` request property's minLength was decreased from `1` to `0`
  - removed `#/components/schemas/BetaManagedAgentsMcpOauthRefreshResponse` from the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/refresh` 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/BetaManagedAgentsMcpOauthRefreshResponse, subschema #2` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/refresh` 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`
  - added `#/components/schemas/BetaTimestamp, subschema #2` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthAuthResponse]/expires_at` response property `anyOf` list for the response status `200`
- **2026-06-30** `26335fd8487a`: 2 info
  - added the new optional request property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams]/injection_location`
  - added the required property `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/oneOf[#/components/schemas/BetaManagedAgentsEnvironmentVariableAuthResponse]/injection_location` to the response with the `200` status
- **2026-06-09** `2336fecb081b`: 1 breaking, 3 info
  - added `#/components/schemas/BetaManagedAgentsEnvironmentVariableAuthResponse` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/` response property `oneOf` list for the response status `200`
  - added `environment_variable` discriminator mapping keys to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/` request property
  - added `#/components/schemas/BetaManagedAgentsEnvironmentVariableUpdateParams` to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/` request property `oneOf` list
  - added `environment_variable` discriminator mapping keys to the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialAuth]/` response property for the response status `200`
- **2026-04-16** `e0696f59ae07`: 1 info
  - the `auth/allOf[#/components/schemas/BetaManagedAgentsCredentialUpdateAuth]/oneOf[#/components/schemas/BetaManagedAgentsMcpOauthUpdateParams]/refresh/allOf[#/components/schemas/BetaManagedAgentsMcpOauthRefreshUpdateParams]/scope` request property's maxLength was increased from `2048` to `8192`
- **2026-04-08** `69486316563e`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/anthropics/apis/anthropic-api/docs/v1/vaults/:vault_id/credentials/:credential_id%3Fbeta=true/post.md) - [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) - [Page](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/vaults/:vault_id/credentials/:credential_id%3Fbeta=true/post)
