---
title: "Changes to Read Secret"
method: GET
path: "/secrets/{secret_id_or_slug}"
---

# Changes to Read Secret

`GET /secrets/{secret_id_or_slug}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 101 revisions.

- **2026-10-28** `c73e2d6d0d56`: 4 info
- **2026-10-21** `1d98cd0e4892`: 1 warning
- **2026-10-18** `722c7cc3556b`: 1 info
- **2026-10-08** `ad74c9933b67`: 4 info
- **2026-09-25** `ec21cdc5486c`: 1 warning, 2 info
- **2026-09-24** `a28f1d059149`: 1 warning, 1 info
- **2026-09-23** `89054d43d2f0`: 2 warning
- **2026-09-20** `7a4b57044657`: 3 warning, 2 info
- **2026-09-11** `d737e09b0d4e`: 1 warning, 1 info
- **2026-09-09** `ecf84135992c`: 1 info
- **2026-08-25** `328550f25b95`: 8 breaking, 3 info
- **2026-08-14** `3ef89c8a67c5`: 3 info

## Changes

- **2026-10-28** `c73e2d6d0d56`: 4 info
  - added the new optional `query` request parameter `scope`
  - added the optional property `availability` to the response with the `200` status
  - added the optional property `owner` to the response with the `200` status
  - added the optional property `selected_project_ids` to the response with the `200` status
- **2026-10-21** `1d98cd0e4892`: 1 warning
  - added the new `claude` enum value to the `data/anyOf[subschema #10: SubscriptionProviderDTO]/provider` response property for the response status `200`
- **2026-10-18** `722c7cc3556b`: 1 info
  - added the optional property `data/anyOf[subschema #9: OAuthGrantDTO]/grant/client_id` to the response with the `200` status
- **2026-10-08** `ad74c9933b67`: 4 info
  - 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, 2 info
  - added the new `whatsapp` enum value to the `data/anyOf[subschema #7: ChannelSecretDTO]/kind` response property for the response status `200`
  - 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, 1 info
  - added the new `channel_secret` enum value to the `kind` response property for the response status `200`
  - added `#/components/schemas/ChannelSecretDTO` to the `data` response property `anyOf` list for the response status `200`
- **2026-09-23** `89054d43d2f0`: 2 warning
  - 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`
- **2026-09-20** `7a4b57044657`: 3 warning, 2 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 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, 1 info
  - added the new `subscription_provider` enum value to the `kind` response property for the response status `200`
  - added `#/components/schemas/SubscriptionProviderDTO` to the `data` response property `anyOf` list for the response status `200`
- **2026-09-09** `ecf84135992c`: 1 info
  - 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, 3 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 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`: 3 info
  - 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

---

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