Unpin Configuration for Flow Control Key

Removes the pinned configuration for a specific flow-control key.

POST /v2/flowControl/{flowControlKey}/unpin

Unpin Configuration for Flow Control Key

cURL

curl --request POST \
  --url https://qstash.upstash.io/v2/flowControl/{flowControlKey}/unpin \
  --header 'Authorization: Bearer <token>'

400

{
  "error": "<string>"
}

Normally, each message sent to QStash includes a flow-control configuration for the corresponding flow-control key, and the processing configuration is updated according to incoming messages.

When a configuration is pinned, the system ignores configurations provided by incoming messages and continues using the pinned configuration.

Calling this endpoint removes the pinned configuration. After unpinning, the system resumes the default behavior and updates the configuration based on configurations provided by incoming messages.

Message delivery will initially continue using the last pinned configuration. Once a new message with a different configuration is received, the system updates the configuration accordingly.

Use this API when you want to return to the default flow-control behavior after temporarily pinning a configuration.

Authorizations

bearerAuthbearerAuthQuery

Authorization · string · header · required

QStash authentication token

Path Parameters

flowControlKey · string · required

The flow-control key for which the configuration will be unpinned.

Query Parameters

parallelism · boolean · default: false

The flag to indicate whether to unpin the parallelism configuration.

rate · boolean · default: false

The flag to indicate whether to unpin the rate configuration.

Response

200

The flow-control key configuration is pinned