---
title: "Changes to Create or replace AI secret"
method: PUT
path: "/v1/ai_secret"
---

# Changes to Create or replace AI secret

`PUT /v1/ai_secret`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 101 revisions.

- **2026-10-30** `8f5039399f77`: 5 breaking
- **2026-09-03** `ebac33c1422e`: 1 breaking
- **2026-05-21** `7c3461755f69`: 2 info
- **2025-06-17** `77a2d5797d94`: 1 info
- **2024-09-30** `ac2727014d93`: 6 breaking, 1 info
- **2024-09-23** `35ca662bf690`: 1 info

## Changes

- **2026-10-30** `8f5039399f77`: 5 breaking
  - the request property `metadata` became not nullable
  - the request property `metadata/additionalProperties/` became not nullable
  - the request property `org_name` became not nullable
  - the request property `secret` became not nullable
  - the request property `type` became not nullable
- **2026-09-03** `ebac33c1422e`: 1 breaking
  - request body became required
- **2026-05-21** `7c3461755f69`: 2 info
  - added the optional property `secret_updated_at` to the response with the `200` status
  - added the optional property `secret_updated_by_user_id` to the response with the `200` status
- **2025-06-17** `77a2d5797d94`: 1 info
  - added the optional property `updated_at` to the response with the `200` status
- **2024-09-30** `ac2727014d93`: 6 breaking, 1 info
  - the response's body became nullable
  - the response's body became nullable
  - the response's body became nullable
  - the response's body became nullable
  - the response's body became nullable
  - the response property `metadata/additionalProperties/` became nullable for the status `200`
  - the request property `metadata/additionalProperties/` became nullable
- **2024-09-23** `35ca662bf690`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/braintrustdata/apis/braintrust-api/docs/v1/ai_secret/put.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/ai_secret/put)