Set Secret | BCTRL Docs

Create or replace one vault secret using the key from the path. Secret values are write-only on this route: reads and lists return metadata by default, and raw value access is limited to the dedicated value endpoint and the caller’s vault policy.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

keystringRequired

Request

This endpoint expects an object.

valueobjectRequired

Response

hasTotpboolean

keystringformat: "^[\[email protected]]+(\/[\[email protected]]+)*$"1-256 characters

typeenum

createdAtstring

labelstring

originPatternslist of strings

originslist of strings

updatedAtstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

$	curl -X PUT https://api.bctrl.ai/v1/vault/secrets/key \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"type": "login",
>	"password": "S3cur3P@ssw0rd!",
>	"username": "[email protected]"
>	}'

1	{
2	"hasTotp": true,
3	"key": "user/[email protected]",
4	"type": "login",
5	"createdAt": "2024-06-01T09:15:00Z",
6	"label": "Jane Doe Email Account",
7	"originPatterns": [
8	"https://mail.example.com/*"
9	],
10	"origins": [
11	"https://mail.example.com"
12	],
13	"updatedAt": "2024-06-01T09:15:00Z"
14	}