Replace secret value | ibee

Creates a new version of the secret value. Requires scope: secret-store.write.

AuthorizationBearer

IBEE platform API token, for example: ibee_live_xxx.

secret_idstringRequired

Secret ID.

workspace_idstringRequired

The workspace ID to scope this request to.

This endpoint expects an object.

valuemap from strings to anyRequired

Key-value pairs containing the new secret data. Creates a new version.

casinteger or nullOptional

Check-and-set: only update if the current version matches this number. Prevents overwriting concurrent changes.

Secret value updated successfully.

idstring

secret_namestring

datamap from strings to any

Key-value pairs containing the secret data.

metadatamap from strings to any

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X PUT "https://api.ibee.ai/v1/secret-store/secrets/019f1e4b-4a2c-71d0-a8b3-c5f92e7d1a4b/value?workspace_id=workspace_id" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"value": {
>	"url": "postgres://user:updated@host:5432/mydb"
>	},
>	"cas": 1
>	}'

1	{
2	"id": "secret_123",
3	"secret_name": "database-url",
4	"data": {
5	"url": "postgres://user:pass@host:5432/mydb"
6	},
7	"metadata": {
8	"version": 1,
9	"created_time": "2026-06-29T00:00:00Z"
10	}
11	}