List Queues

Overview

Returns a paginated list of all queues in the current environment. Each queue object includes current run counts, concurrency configuration, and pause state. There are two types of queues:

task queues — automatically created for every task.
custom queues — explicitly defined in code using queue() and shared across tasks.

Authentication with a secret key is required.

Endpoint

GET https://api.trigger.dev/api/v1/queues

Query parameters

integer

Page number (1-based). Defaults to 1.

integer

Number of queues per page.

Response

object[]

Array of queue objects.

Show Queue object fields

string

Queue ID, prefixed with queue_.

string

Queue name. For task queues this is the task ID; for custom queues it is the name you specified.

string

task or custom.

integer

Number of runs currently executing.

integer

Number of runs currently waiting in the queue.

boolean

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

integer | null

The current effective concurrency limit, if set.

object

Detailed concurrency information.

Show concurrency fields

integer | null

Effective concurrency limit.

integer | null

Base limit defined in code.

integer | null

Override value, if an override is active.

string | null

When the override was applied.

string | null

Who applied the override (null if via API).

object

Show pagination fields

integer

Current page number.

integer

Total pages available.

integer

Total number of queues.

Examples

import { queues } from "@trigger.dev/sdk";

// List all queues
const result = await queues.list();

for (const queue of result.data) {
  console.log(
    `${queue.name}: ${queue.running} running, ${queue.queued} queued, paused=${queue.paused}`
  );
}

import { queues } from "@trigger.dev/sdk";

const result = await queues.list({ page: 1, perPage: 20 });

console.log(`Showing ${result.data.length} of ${result.pagination.count} queues`);

curl "https://api.trigger.dev/api/v1/queues?page=1&perPage=20" \
  -H "Authorization: Bearer tr_dev_1234"

Response example

{
  "data": [
    {
      "id": "queue_1234",
      "name": "my-task",
      "type": "task",
      "running": 2,
      "queued": 8,
      "paused": false,
      "concurrencyLimit": 10,
      "concurrency": {
        "current": 10,
        "base": 10,
        "override": null,
        "overriddenAt": null,
        "overriddenBy": null
      }
    },
    {
      "id": "queue_5678",
      "name": "email-queue",
      "type": "custom",
      "running": 0,
      "queued": 0,
      "paused": true,
      "concurrencyLimit": 5,
      "concurrency": {
        "current": 5,
        "base": 5,
        "override": null,
        "overriddenAt": null,
        "overriddenBy": null
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 2,
    "count": 24
  }
}

Overview

Tasks & Runs

Schedules & Queues

Waitpoints & Env Vars

Overview

Endpoint

Query parameters

Response

Examples

Response example

​Overview

​Endpoint

​Query parameters

​Response

​Examples

​Response example

Overview

Endpoint

Query parameters

Response

Examples

Response example