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

# Changes to Create Secret

`POST /secrets/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 97 revisions.

- **2026-10-21** `1d98cd0e4892`: 1 warning, 1 info
- **2026-10-18** `722c7cc3556b`: 2 info
- **2026-10-08** `ad74c9933b67`: 8 info
- **2026-09-25** `ec21cdc5486c`: 1 warning, 5 info
- **2026-09-24** `a28f1d059149`: 1 warning, 3 info
- **2026-09-23** `89054d43d2f0`: 2 warning, 2 info
- **2026-09-20** `7a4b57044657`: 3 warning, 7 info
- **2026-09-11** `d737e09b0d4e`: 1 warning, 3 info
- **2026-09-09** `ecf84135992c`: 2 info
- **2026-08-25** `328550f25b95`: 8 breaking, 12 info
- **2026-08-14** `3ef89c8a67c5`: 6 info
- **2026-07-25** `5a14788d939f`: 1 warning, 5 info
- **2026-05-08** `5e6f53ce5d08`: 1 info
- **2025-06-27** `e3e84db47198`: 1 breaking

## Changes

- **2026-10-21** `1d98cd0e4892`: 1 warning, 1 info
  - added the new `claude` enum value to the `data/anyOf[subschema #10: SubscriptionProviderDTO]/provider` response property for the response status `200`
  - added the new `claude` enum value to the request property `secret/data/anyOf[subschema #10: SubscriptionProviderDTO]/provider`
- **2026-10-18** `722c7cc3556b`: 2 info
  - added the new optional request property `secret/data/anyOf[subschema #9: OAuthGrantDTO]/grant/client_id`
  - added the optional property `data/anyOf[subschema #9: OAuthGrantDTO]/grant/client_id` to the response with the `200` status
- **2026-10-08** `ad74c9933b67`: 8 info
  - added the new optional request property `secret/data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/error`
  - added the new optional request property `secret/data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/runner_address`
  - added the new optional request property `secret/data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/runner_replica_id`
  - added the new optional request property `secret/data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/state`
  - added the optional property `data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/error` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/runner_address` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/runner_replica_id` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #10: SubscriptionProviderDTO]/login_attempt/anyOf[subschema #1: SubscriptionLoginAttemptDTO]/state` to the response with the `200` status
- **2026-09-25** `ec21cdc5486c`: 1 warning, 5 info
  - added the new `whatsapp` enum value to the `data/anyOf[subschema #7: ChannelSecretDTO]/kind` response property for the response status `200`
  - added the new optional request property `secret/data/anyOf[subschema #7: ChannelSecretDTO]/channel/access_token`
  - added the new optional request property `secret/data/anyOf[subschema #7: ChannelSecretDTO]/channel/app_secret`
  - added the new `whatsapp` enum value to the request property `secret/data/anyOf[subschema #7: ChannelSecretDTO]/kind`
  - added the optional property `data/anyOf[subschema #7: ChannelSecretDTO]/channel/access_token` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #7: ChannelSecretDTO]/channel/app_secret` to the response with the `200` status
- **2026-09-24** `a28f1d059149`: 1 warning, 3 info
  - added the new `channel_secret` enum value to the `kind` response property for the response status `200`
  - added `#/components/schemas/ChannelSecretDTO` to the `secret/data` request property `anyOf` list
  - added the new `channel_secret` enum value to the request property `secret/kind`
  - added `#/components/schemas/ChannelSecretDTO` to the `data` response property `anyOf` list for the response status `200`
- **2026-09-23** `89054d43d2f0`: 2 warning, 2 info
  - added the new `xai` enum value to the `data/anyOf[subschema #1: StandardProviderDTO]/kind` response property for the response status `200`
  - added the new `xai` enum value to the `data/anyOf[subschema #3: CustomProviderDTO]/kind` response property for the response status `200`
  - added the new `xai` enum value to the request property `secret/data/anyOf[subschema #1: StandardProviderDTO]/kind`
  - added the new `xai` enum value to the request property `secret/data/anyOf[subschema #3: CustomProviderDTO]/kind`
- **2026-09-20** `7a4b57044657`: 3 warning, 7 info
  - added the new `mock` enum value to the `data/anyOf[subschema #1: StandardProviderDTO]/kind` response property for the response status `200`
  - added the new `oauth_grant` enum value to the `kind` response property for the response status `200`
  - added the new `oauth_provider` enum value to the `kind` response property for the response status `200`
  - added the new optional request property `secret/data/anyOf[subschema #2: CustomProviderDTO -> subschema #3: CustomProviderDTO]/protocol`
  - added `#/components/schemas/MCPStandardProviderDTO, #/components/schemas/OAuthProviderDTO, #/components/schemas/OAuthGrantDTO` to the `secret/data` request property `anyOf` list
  - added the new `mock` enum value to the request property `secret/data/anyOf[subschema #1: StandardProviderDTO]/kind`
  - added the new `oauth_grant` enum value to the request property `secret/kind`
  - added the new `oauth_provider` enum value to the request property `secret/kind`
  - added the optional property `data/anyOf[subschema #2: CustomProviderDTO -> subschema #3: CustomProviderDTO]/protocol` to the response with the `200` status
  - added `#/components/schemas/MCPStandardProviderDTO, #/components/schemas/OAuthProviderDTO, #/components/schemas/OAuthGrantDTO` to the `data` response property `anyOf` list for the response status `200`
- **2026-09-11** `d737e09b0d4e`: 1 warning, 3 info
  - added the new `subscription_provider` enum value to the `kind` response property for the response status `200`
  - added `#/components/schemas/SubscriptionProviderDTO` to the `secret/data` request property `anyOf` list
  - added the new `subscription_provider` enum value to the request property `secret/kind`
  - added `#/components/schemas/SubscriptionProviderDTO` to the `data` response property `anyOf` list for the response status `200`
- **2026-09-09** `ecf84135992c`: 2 info
  - added the new optional request property `secret/data/anyOf[subschema #5: CustomSecretDTO]/secret/default_env_var`
  - added the optional property `data/anyOf[subschema #5: CustomSecretDTO]/secret/default_env_var` to the response with the `200` status
- **2026-08-25** `328550f25b95`: 8 breaking, 12 info
  - the response property `data/anyOf[subschema #1: StandardProviderDTO]/provider/key` became optional for the status `200`
  - the response property `data/anyOf[subschema #3: SSOProviderDTO]/provider/client_secret` became optional for the status `200`
  - the response property `data/anyOf[subschema #4: WebhookProviderDTO]/provider/key` became optional for the status `200`
  - the response property `data/anyOf[subschema #5: CustomSecretDTO]/secret/content` became optional for the status `200`
  - response property `data/anyOf[subschema #1: StandardProviderDTO]/provider/key` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/anyOf[subschema #3: SSOProviderDTO]/provider/client_secret` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/anyOf[subschema #4: WebhookProviderDTO]/provider/key` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/anyOf[subschema #5: CustomSecretDTO]/secret/content` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the new optional request property `write_only`
  - the request property `secret/data/anyOf[subschema #1: StandardProviderDTO]/provider/key` became optional
  - the request property `secret/data/anyOf[subschema #3: SSOProviderDTO]/provider/client_secret` became optional
  - the request property `secret/data/anyOf[subschema #4: WebhookProviderDTO]/provider/key` became optional
  - the request property `secret/data/anyOf[subschema #5: CustomSecretDTO]/secret/content` became optional
  - request property `secret/data/anyOf[subschema #1: StandardProviderDTO]/provider/key` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `secret/data/anyOf[subschema #3: SSOProviderDTO]/provider/client_secret` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `secret/data/anyOf[subschema #4: WebhookProviderDTO]/provider/key` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `secret/data/anyOf[subschema #5: CustomSecretDTO]/secret/content` list-of-types was widened by adding types `null` to media type `application/json`
  - added the optional property `management` to the response with the `200` status
  - added the optional property `write_only` to the response with the `200` status
  - added the required property `value_status` to the response with the `200` status
- **2026-08-14** `3ef89c8a67c5`: 6 info
  - added the new optional request property `secret/data/anyOf[subschema #1: StandardProviderDTO]/harnesses`
  - added the new optional request property `secret/data/anyOf[subschema #1: StandardProviderDTO]/models`
  - added the new optional request property `secret/data/anyOf[subschema #2: CustomProviderDTO]/harnesses`
  - added the optional property `data/anyOf[subschema #1: StandardProviderDTO]/harnesses` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1: StandardProviderDTO]/models` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #2: CustomProviderDTO]/harnesses` to the response with the `200` status
- **2026-07-25** `5a14788d939f`: 1 warning, 5 info
  - added the new `custom_secret` enum value to the `kind` response property for the response status `200`
  - added the new optional request property `slug`
  - added `#/components/schemas/CustomSecretDTO` to the `secret/data` request property `anyOf` list
  - added the new `custom_secret` enum value to the request property `secret/kind`
  - added the optional property `slug` to the response with the `200` status
  - added `#/components/schemas/CustomSecretDTO` to the `data` response property `anyOf` list for the response status `200`
- **2026-05-08** `5e6f53ce5d08`: 1 info
  - endpoint added
- **2025-06-27** `e3e84db47198`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/agenta-ai/apis/agenta-api/docs/secrets/post.md) - [API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) - [Page](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/secrets/post)