diff --git a/llms-full.txt b/llms-full.txt index 03b7de4b6..65b2b7e9d 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -25533,15 +25533,30 @@ Your token is used to interact with the QStash API. You need it to publish messages as well as create, read, update or delete other resources, such as URL Groups and endpoints. -Resetting your token will invalidate your current token and all future requests -with the old token will be rejected. +You can reset your token without downtime. QStash accepts both your current +token and the new one until you rotate, so your applications keep working while +you switch over. -To reset your token, simply click on the "Reset token" button at the bottom in -the [QStash UI](https://console.upstash.com/qstash) and confirm the dialog. +To reset your token, click "Reset" next to "Reset Token" in the +[QStash UI](https://console.upstash.com/qstash). The dialog walks you through +two steps: + +1. **Update your applications.** Copy the new token and replace `QSTASH_TOKEN` + in your applications and environments. The dialog also offers a read-only + variant of the token. + + If you use the Vercel integration, `QSTASH_TOKEN` in your Vercel project is + already set to the new token. Redeploy before you rotate. + +2. **Rotate Tokens.** Click "Rotate Tokens" once all your applications use the + new token. The old token stops working and the new one keeps working. + +You can close the dialog before rotating. The new token stays ready, and you +can finish the rotation later from Settings. ![]() -Afterwards you should immediately update your token in all your applications. +QStash and Workflow share this token. # Run a Delayed Message Now Source: https://upstash.com/docs/qstash/howto/retry-now diff --git a/qstash/howto/reset-token.mdx b/qstash/howto/reset-token.mdx index f2858d0c1..5803b6ebf 100644 --- a/qstash/howto/reset-token.mdx +++ b/qstash/howto/reset-token.mdx @@ -6,12 +6,27 @@ Your token is used to interact with the QStash API. You need it to publish messages as well as create, read, update or delete other resources, such as URL Groups and endpoints. -Resetting your token will invalidate your current token and all future requests -with the old token will be rejected. +You can reset your token without downtime. QStash accepts both your current +token and the new one until you rotate, so your applications keep working while +you switch over. -To reset your token, simply click on the "Reset token" button at the bottom in -the [QStash UI](https://console.upstash.com/qstash) and confirm the dialog. +To reset your token, click "Reset" next to "Reset Token" in the +[QStash UI](https://console.upstash.com/qstash). The dialog walks you through +two steps: + +1. **Update your applications.** Copy the new token and replace `QSTASH_TOKEN` + in your applications and environments. The dialog also offers a read-only + variant of the token. + + If you use the Vercel integration, `QSTASH_TOKEN` in your Vercel project is + already set to the new token. Redeploy before you rotate. + +2. **Rotate Tokens.** Click "Rotate Tokens" once all your applications use the + new token. The old token stops working and the new one keeps working. + +You can close the dialog before rotating. The new token stays ready, and you +can finish the rotation later from Settings. ![](/img/qstash/reset_token.png) -Afterwards you should immediately update your token in all your applications. +QStash and Workflow share this token.