FruxonDocs
ApiSecrets

Rotates the secret to a new value.

Encrypts the supplied plaintext, persists it as a new immutable revision, and atomically points the published revision at the new row. Previous revisions remain in history for rollback.

POST
/v1/tenants/{tenant}/secrets/{secret}:publish

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

secret*string

The secret identifier (Guid).

Formatuuid
tenant*string

The tenant identifier

Request Body

The publish payload with the new plaintext value.

value*string|null

New plaintext value. Encrypted at rest immediately. Required — publishing without changing the value would just duplicate the prior revision; if you want that, call this endpoint with the same value and a note.

note?string|null
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/secrets/497f6eca-6276-4993-bfeb-53cbbbba6f08:publish" \  -H "Content-Type: application/json" \  -d '{    "value": "string"  }'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "secretId": "00000000-0000-0000-0000-000000000000",
  "version": 0,
  "sensitivity": "STANDARD",
  "note": "string",
  "createdBy": "string",
  "createdAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}