Secrets

Rotate: store a new value as the next version

The new version is used from the next session start; every older version’s value is erased in the same transaction (metadata kept). Values already injected into running processes are not recalled. Supports Idempotency-Key.

post/v1/secrets/{secret_id}/versions

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/secrets/{secret_id}/versions
  • Auth: HTTP bearer

Path parameters

secret_idstring uuid required

UUIDv7, lowercase canonical form.

Request body

valuestring required

UTF-8 text, at most 65536 bytes, no NUL characters. Write-only: never returned by any management API.

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.