Rotate Signing Keys

Rotate your signing keys

1 min read

post/v2/keys/rotate

Request example

curl --request POST \
  --url https://qstash-eu-central-1.upstash.io/v2/keys/rotate \
  --header 'Authorization: Bearer <token>'

Response

{
  "current": "<string>",
  "next": "<string>"
}

post/v2/keys/rotate

Rotating signing keys lets you switch the keys used to sign messages without causing downtime. This ensures that signatures remain valid and that the application can continue verifying new messages seamlessly.

During a rotation, the next key becomes the new current key, and a fresh next key is generated.

Make sure to update your application to use the new current and next keys after rotation.

Authorization

Authorizationstringheaderrequired#

QStash authentication token

1 alternative authorization method available — see the spec for details.

Responses

application/json

200

Keys rotated successfully

currentstring#

The current signing key.

nextstring#

The next signing key.

Get Signing Keys Notify Event