Fix: improve qstash url/token (#760)

* feat: improve qstash url/token descriptions

* feat: add workflow get-token page, link quickstarts to token sections

* chore(llms): regenerate llms.txt and llms-full.txt

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: CahidArda

docs.json

@@ -1371,6 +1371,7 @@
                   "workflow/howto/configure",
                   "workflow/howto/cancel",
                   "workflow/howto/security",
+                  "workflow/howto/get-token",
                   "workflow/howto/readonly-token",
                   "workflow/howto/redact-fields",
                   "workflow/howto/changes",

img/qstash-workflow/console-quickstart-env.jpg

@@ -10854,8 +10854,9 @@ Source: https://upstash.com/docs/qstash/features/security
 
 ### Request Authorization
 
-When interacting with the QStash API, you will need an authorization token. You
-can get your token from the [Console](https://console.upstash.com/qstash).
+When interacting with the QStash API, you will need an authorization token. To
+get your token, go to the [QStash tab in the Console](https://console.upstash.com/qstash),
+pick a region, and copy the `QSTASH_TOKEN` from the **Quickstart** section.
 
   <img />
 
@@ -11436,6 +11437,12 @@ QStash is available in two regions: **EU region** and **US region**. Each region
 * **EU Region**: `https://qstash-eu-central-1.upstash.io`, or `https://qstash.upstash.io`
 * **US Region**: `https://qstash-us-east-1.upstash.io`
 
+`QSTASH_URL` is optional. When it is not set, SDKs default to the EU region
+(`https://qstash.upstash.io`). To use the US region, set `QSTASH_URL` to the US
+regional URL together with that region's `QSTASH_TOKEN` and signing keys — you can
+copy all of them from the **Quickstart** section of the
+[QStash Console](https://console.upstash.com/qstash).
+
 ## Key Concepts
 
 Each QStash region maintains:
@@ -13901,10 +13908,11 @@ messages to. If you don't, you can use something like
 
 For example, you can use this URL to test your messages: [https://firstqstashmessage.requestcatcher.com](https://firstqstashmessage.requestcatcher.com)
 
-### Get your token
+### Get your QStash Token
 
-Go to the [Upstash Console](https://console.upstash.com/qstash) and copy the
-`QSTASH_TOKEN`.
+Go to the [QStash tab in the Upstash Console](https://console.upstash.com/qstash),
+pick the region you want to use (see [Select a Region](/docs/qstash/howto/multi-region)),
+and copy the `QSTASH_TOKEN` from the **Quickstart** section.
 
   <img />
 
@@ -49410,6 +49418,22 @@ For example, let's debug the following failed run. Judging by the status code `4
 # Flow control
 Source: https://upstash.com/docs/workflow/howto/flow-control
 
+# Get your QStash Token
+Source: https://upstash.com/docs/workflow/howto/get-token
+
+Upstash Workflow is powered by [QStash](/docs/qstash/overall/getstarted), so your app
+authenticates with a QStash token. Go to the
+[Workflow tab in the Upstash Console](https://console.upstash.com/workflow), pick
+the region you want to use, and copy the `QSTASH_TOKEN` from the **Quickstart**
+section.
+
+  <img />
+
+<Info>
+If you want to safely share a token with your team or AI agents, you can use a
+[read-only token](/docs/workflow/howto/readonly-token) instead.
+</Info>
+
 # Development Server
 Source: https://upstash.com/docs/workflow/howto/local-development/development-server
 

img/qstash-workflow/qstash_token.png

@@ -1046,6 +1046,7 @@
 - [Configure a Run](https://upstash.com/docs/workflow/howto/configure.md)
 - [Handle Failed Runs](https://upstash.com/docs/workflow/howto/failures.md)
 - [Flow control](https://upstash.com/docs/workflow/howto/flow-control.md)
+- [Get your QStash Token](https://upstash.com/docs/workflow/howto/get-token.md)
 - [Development Server](https://upstash.com/docs/workflow/howto/local-development/development-server.md)
 - [Local Tunnel](https://upstash.com/docs/workflow/howto/local-development/local-tunnel.md)
 - [Middlewares](https://upstash.com/docs/workflow/howto/middlewares.md)

img/qstash/console-quickstart-env.jpg

@@ -4,11 +4,12 @@ title: "Security"
 
 ### Request Authorization
 
-When interacting with the QStash API, you will need an authorization token. You
-can get your token from the [Console](https://console.upstash.com/qstash).
+When interacting with the QStash API, you will need an authorization token. To
+get your token, go to the [QStash tab in the Console](https://console.upstash.com/qstash),
+pick a region, and copy the `QSTASH_TOKEN` from the **Quickstart** section.
 
 <Frame>
-  <img src="/img/qstash/rest_token.png" />
+  <img src="/img/qstash/console-quickstart-env.jpg" />
 </Frame>
 
 Send this token along with every request made to `QStash` inside the

img/qstash/rest_token.png

@@ -11,6 +11,12 @@ QStash is available in two regions: **EU region** and **US region**. Each region
 - **EU Region**: `https://qstash-eu-central-1.upstash.io`, or `https://qstash.upstash.io`
 - **US Region**: `https://qstash-us-east-1.upstash.io`
 
+`QSTASH_URL` is optional. When it is not set, SDKs default to the EU region
+(`https://qstash.upstash.io`). To use the US region, set `QSTASH_URL` to the US
+regional URL together with that region's `QSTASH_TOKEN` and signing keys — you can
+copy all of them from the **Quickstart** section of the
+[QStash Console](https://console.upstash.com/qstash).
+
 ## Key Concepts
 
 Each QStash region maintains:

llms-full.txt

@@ -61,13 +61,14 @@ messages to. If you don't, you can use something like
 
 For example, you can use this URL to test your messages: [https://firstqstashmessage.requestcatcher.com](https://firstqstashmessage.requestcatcher.com)
 
-### Get your token
+### Get your QStash Token
 
-Go to the [Upstash Console](https://console.upstash.com/qstash) and copy the
-`QSTASH_TOKEN`.
+Go to the [QStash tab in the Upstash Console](https://console.upstash.com/qstash),
+pick the region you want to use (see [Select a Region](/qstash/howto/multi-region)),
+and copy the `QSTASH_TOKEN` from the **Quickstart** section.
 
 <Frame>
-  <img src="/img/qstash/rest_token.png" />
+  <img src="/img/qstash/console-quickstart-env.jpg" />
 </Frame>
 
 ### Publish a message