Queues

Upsert a Queue

Updates or creates a queue

POST/v2/queues
cURL
curl --request POST \
  --url https://qstash-{region}.upstash.io/v2/queues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "queueName": "<queueName>",
    "parallelism": 0
  }'

Authorization

Authorizationheaderstringrequired

Bearer authentication header of the form Bearer <token>.

Body

queueNamestringrequired

The name of the queue

parallelismintegerdefault: 1required

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

Response

200 — Queue created or updated successfully

400 — Queue name is invalid. Queue names can only contain alphanumeric characters, hyphens, periods, and underscores.

errorstringrequired

Error message

412 — Either exceeded the maximum number of queues allowed or the maximum parallelism per queue.

errorstringrequired

Error message

Loading search…