---
title: "Changes to Update secret"
method: PUT
path: "/v1/secrets/{id}"
---

# Changes to Update secret

`PUT /v1/secrets/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 100 revisions.

- **2025-12-01** `87688d3474c2`: 1 warning, 1 info
- **2025-10-08** `7720df04e5f1`: 1 info
- **2025-09-25** `0ff040c5bf20`: 2 warning, 2 info
- **2025-06-03** `a210961eeca2`: 3 warning, 1 info
- **2025-05-27** `dfa71f9d277e`: 4 breaking, 1 warning, 3 info
- **2025-04-04** `06c7f9e7d5c4`: 1 warning, 1 info
- **2025-03-18** `d8ef59d98e13`: 1 info

## Changes

- **2025-12-01** `87688d3474c2`: 1 warning, 1 info
  - added the new `SCOPE_AI_GATEWAY` enum value to the `secret/scopes/items/` response property for the response status `200`
  - added the new `SCOPE_AI_GATEWAY` enum value to the request property `scopes/items/`
- **2025-10-08** `7720df04e5f1`: 1 info
  - the request property `secret_data` became optional
- **2025-09-25** `0ff040c5bf20`: 2 warning, 2 info
  - added the new `SCOPE_AI_AGENT` enum value to the `secret/scopes/items/` response property for the response status `200`
  - added the new `SCOPE_MCP_SERVER` enum value to the `secret/scopes/items/` response property for the response status `200`
  - added the new `SCOPE_AI_AGENT` enum value to the request property `scopes/items/`
  - added the new `SCOPE_MCP_SERVER` enum value to the request property `scopes/items/`
- **2025-06-03** `a210961eeca2`: 3 warning, 1 info
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `labels` from the response with the `200` status
  - removed the optional property `scopes` from the response with the `200` status
  - added the optional property `secret` to the response with the `200` status
- **2025-05-27** `dfa71f9d277e`: 4 breaking, 1 warning, 3 info
  - the request property `secret_data` became required
  - removed the enum value `SCOPE_AI_AGENT` of the request property `scopes/items/`
  - removed the enum value `SCOPE_AI_GATEWAY` of the request property `scopes/items/`
  - removed the enum value `SCOPE_MCP_SERVER` of the request property `scopes/items/`
  - removed the optional property `secret` from the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the optional property `labels` to the response with the `200` status
  - added the optional property `scopes` to the response with the `200` status
- **2025-04-04** `06c7f9e7d5c4`: 1 warning, 1 info
  - added the new `SCOPE_REDPANDA_CLUSTER` enum value to the `scopes/items/` response property for the response status `200`
  - added the new `SCOPE_REDPANDA_CLUSTER` enum value to the request property `scopes/items/`
- **2025-03-18** `d8ef59d98e13`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/docs/v1/secrets/:id/put.md) - [API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) - [Page](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/secrets/:id/put)