vault.rotate()

`vault.rotate()`

Adds a new immutable revision to an existing parent. Returns its metadata, never value. Default/null validFrom activates now and retires previous eligible/scheduled revisions. A future validFrom schedules activation while the current value remains available until then. Duplicate validFrom conflicts. Cache invalidation follows commit; no relogin is required. Instance total/active revision quotas remain enforced.

Signature

static rotate(name: string, data: SecretRotateInput, options?: SecretRotateOptions): Promise<SecretWithRevision | null>;

Example

const rotated = await vault.rotate('TOKEN', { value: input.token }, { scope: 'user', validFrom: null });

See all vault methods or runtime basics.

Last modified on November 8, 2026

Low-code method reference

Developer tools

Before you start

Platform API

`vault.rotate()`

Signature

Example

​vault.rotate()

​Signature

​Example

`vault.rotate()`

Signature

Example