List Flow Control Keys

List all Flow Control keys used in workflows.

Flow Control keys are used to manage concurrency and rate limiting for workflow steps. This endpoint returns all active flow control keys with their current waitlist sizes, sorted by waitlist size in descending order. Results are limited to 1000 keys.

GET /v2/flowControl

List Flow Control Keys

cURL

curl --request GET \
  --url https://qstash.upstash.io/v2/flowControl \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "flowControlKey": "<string>",
    "waitlistSize": 123
  }
]

Authorizations

bearerAuthbearerAuthQuery

Authorization · string · header · required

QStash authentication token

Query Parameters

search · string

Optional search string to filter flow control keys by name. Only keys containing this string will be returned.

Response

200

application/json

Flow control keys retrieved successfully

flowControlKey · string

The flow control key name

waitlistSize · integer

The number of messages waiting due to flow control configuration.