Skip to content

docs: describe zero-downtime QStash token reset #1008

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
context7 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: describe zero-downtime QStash token reset #1008

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bfe61ff
docs: describe zero-downtime QStash token reset
context7[bot] Nov 10, 2026
80aa082
chore(llms): regenerate llms.txt and llms-full.txt
github-actions[bot] Nov 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 20 additions & 5 deletions llms-full.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
25 changes: 20 additions & 5 deletions qstash/howto/reset-token.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.