Skip to main content
POST
/
v2
/
queues
/
{queueName}
/
pause
Pause Queue
curl --request POST \
  --url https://qstash.upstash.io/v2/queues/{queueName}/pause \
  --header 'Authorization: Bearer <token>'
{
  "error": "<string>"
}
Pausing a queue stops the delivery of enqueued messages. The queue continues to accept new messages, but they will not be delivered until the queue is resumed. If the queue is already paused, this action has no effect.
Resuming or creating a queue may take up to a minute. Therefore, it is not recommended to pause or delete a queue during critical operations.

Authorizations

​
Authorization
string
header
required

QStash authentication token

Path Parameters

​
queueName
string
required

The name of the queue to pause.

Response

Queue paused successfully