---
title: "Override queue concurrency limit"
method: POST
path: "/api/v1/queues/{queueParam}/concurrency/override"
tags: ["queues"]
---

# Override queue concurrency limit

`POST /api/v1/queues/{queueParam}/concurrency/override`

Override the concurrency limit of a queue. This is useful for temporarily scaling up or down based on demand.

## Path parameters

- `queueParam` string, required

## Request body

- object
  - `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
  - `concurrencyLimit` integer, required — The new concurrency limit to set for the queue

## Response `200`

Concurrency limit overridden successfully

- QueueObject
  - `id` string, required — The queue ID, e.g., `queue_1234`
  - `name` string, 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()`
  - `running` integer, required — The number of runs currently executing
  - `queued` integer, required — The number of runs currently queued
  - `paused` boolean, required — Whether the queue is paused. When paused, no new runs will start.
  - `concurrencyLimit` integer, nullable — The current concurrency limit of the queue
  - `concurrency` object — Detailed concurrency information
    - `current` integer, nullable — The effective/current concurrency limit
    - `base` integer, nullable — The base concurrency limit defined in code
    - `override` integer, nullable — The override concurrency limit (if set)
    - `overriddenAt` string, date-time, nullable — When the concurrency limit was overridden
    - `overriddenBy` string, nullable — Who overrode the concurrency limit (null if via API)

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized request
- `404` — Queue not found

---

[API](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api.md) · [All operations](https://skmtc.net/winsenlabs/apis/trigger-dev-v3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/winsenlabs/trigger-dev-v3-rest-api/versions/737c498e605b/schema)