Skip to main content
POST
/
v2
/
queues
Upsert a Queue
curl --request POST \
  --url https://qstash-{region}.upstash.io/v2/queues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queueName": "<string>",
  "parallelism": 1
}
'
{
  "error": "<string>"
}
For rate-limiting use cases, we’ve introduced a more performant and less restrictive Flow Control feature for the Publish API.We are planning to deprecate setting parallelism greater than 1 for the Queue API in future. If you’re currently using Queue API with parallelism greater than 1 for rate limiting, consider using Flow Control.Queues with parallelism set to 1 provide FIFO guarantees, which remains a valid use case for the Queue API.

Authorizations

​
Authorization
string
header
required

QStash authentication token

Body

application/json
​
queueName
string
required

The name of the queue

​
parallelism
integer
default:1
required

The number of parallel consumers consuming from the queue. Must be greater than 0.

Required range: x >= 1

Response

Queue created or updated successfully