Skip to main content
POST
/
v2
/
keys
/
rotate
Rotate Signing Keys
curl --request POST \
  --url https://qstash.upstash.io/v2/keys/rotate \
  --header 'Authorization: Bearer <token>'
{
  "current": "<string>",
  "next": "<string>"
}
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.

Authorizations

​
Authorization
string
header
required

QStash authentication token

Response

200 - application/json

Keys rotated successfully

​
current
string

The current signing key.

​
next
string

The next signing key.