---
title: "Changes to Create secret"
method: POST
path: "/v1/secrets"
---

# Changes to Create secret

`POST /v1/secrets`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 100 revisions.

- **2025-12-01** `87688d3474c2`: 1 warning, 1 info
- **2025-09-25** `0ff040c5bf20`: 2 warning, 2 info
- **2025-06-03** `a210961eeca2`: 3 warning, 1 info
- **2025-05-27** `dfa71f9d277e`: 3 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 `201`
  - added the new `SCOPE_AI_GATEWAY` enum value to the request property `scopes/items/`
- **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 `201`
  - added the new `SCOPE_MCP_SERVER` enum value to the `secret/scopes/items/` response property for the response status `201`
  - 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 `201` status
  - removed the optional property `labels` from the response with the `201` status
  - removed the optional property `scopes` from the response with the `201` status
  - added the optional property `secret` to the response with the `201` status
- **2025-05-27** `dfa71f9d277e`: 3 breaking, 1 warning, 3 info
  - 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 `201` status
  - added the optional property `id` to the response with the `201` status
  - added the optional property `labels` to the response with the `201` status
  - added the optional property `scopes` to the response with the `201` 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 `201`
  - 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/post.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/post)