---
title: "Get Flow Control Key"
method: GET
path: "/v2/keys/rotate"
tags: ["Flow Control"]
---

# Get Flow Control Key

`GET /v2/keys/rotate`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/keys/rotate`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/docs/v2/keys/rotate/get.ts> (a function with typed inputs; its response is checked against the schema)

Get details of a specific Flow Control key.

Flow Control keys are used to manage concurrency and rate limiting for workflow steps.
This endpoint returns the current waitlist size for the specified flow control key,
which indicates how many workflow steps are currently waiting due to flow control constraints.

## Path parameters

- `flowControlKey` string, required

## Response `200`

Flow control key details

- FlowControlKey
  - `flowControlKey` string: The flow control key name
  - `waitlistSize` integer: The number of messages waiting due to flow control configuration.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Flow Control key not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/revisions/251bee05a7ec?raw)