Sign in

v1

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-05-044743166.6 KB
queues

Pause or resume a queue

Pause a queue to prevent new runs from starting, or resume a paused queue. Runs that are currently executing will continue to completion.

post/api/v1/queues/{queueParam}/pause

Path parameters

queueParamstring required

The queue ID (e.g., queue_1234), or the name of the queue when using the type body parameter.

Request body

type'id' | 'task' | 'custom'

How to interpret the queueParam path parameter:

  • id: Treat as a queue ID (default)
  • task: Treat as a task ID to get the task's default queue
  • custom: Treat as a custom queue name
action'pause' | 'resume' required

Whether to pause or resume the queue

Response

Queue paused or resumed successfully

idstring required

The queue ID, e.g., queue_1234

namestring required

The queue name. For task queues, this is the task ID. For custom queues, this is the name you specified.

type'task' | 'custom' required

The type of queue:

  • task: Created automatically for each task
  • custom: Created explicitly in your code using queue()
runninginteger required

The number of runs currently executing

queuedinteger required

The number of runs currently queued

pausedboolean required

Whether the queue is paused. When paused, no new runs will start.

concurrencyLimitinteger nullable

The current concurrency limit of the queue

Example response

{
  "id": "queue_1234",
  "name": "my-task-id",
  "type": "task",
  "running": 5,
  "queued": 10,
  "concurrencyLimit": 10,
  "concurrency": {
    "current": 10,
    "base": 10
  }
}