Monitoring

You can monitor wait list size of your flow control key’s from the console FlowControl tab.

Also you can get the same info using the REST API.

• List All Flow Control Keys.
• Single Flow Control Key.
• Reset Flow Control Key.

Response Fields

Each flow control key returned by the API includes the following metrics:

Field	Description
flowControlKey	The flow control key name
waitListSize	Number of messages currently waiting in the queue
parallelismMax	Configured maximum concurrent messages (if set)
parallelismCount	Number of messages currently running in parallel
rateMax	Configured maximum messages per rate period (if set)
rateCount	Number of messages dispatched in the current rate period
ratePeriod	Rate period length in seconds
ratePeriodStart	Unix timestamp when the current rate period started

Resetting a Flow Control Key

If you need to immediately release queued messages (for example, after a downstream service recovers from an outage), you can reset the flow control counters via the REST API or SDK:

TypeScript

import { Client } from "@upstash/workflow";

const client = new Client({ token: "<QSTASH_TOKEN>" });

await client.flowControl.reset("your-flow-control-key");