🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-04-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Renames the secret and/or rotates its value.

Rotating the value re-encrypts the secret at rest; every tool
that references this secret picks up the new value automatically
without per-tool reconfiguration.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
agents:write