> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

#  

# `prefect work-queue`

```command theme={null}
prefect work-queue [OPTIONS] COMMAND [ARGS]...
```

> [!NOTE]
>
> Manage work queues.

## `prefect work-queue create`

```command theme={null}
prefect work-queue create [OPTIONS] NAME
```

> [!NOTE]
>
> Create a work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The unique name to assign this work queue

> **Options**
>
> **--limit**
>
> The concurrency limit to set on the queue.
>
> **--pool**
>
> The name of the work pool to create the work queue in.
>
> **--priority**
>
> The associated priority for the created work queue

## `prefect work-queue set-concurrency-limit`

```command theme={null}
prefect work-queue set-concurrency-limit [OPTIONS] NAME LIMIT
```

> [!NOTE]
>
> Set a concurrency limit on a work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue
>
> **LIMIT** `string` *required*
>
> The concurrency limit to set on the queue.

> **Options**
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.

## `prefect work-queue clear-concurrency-limit`

```command theme={null}
prefect work-queue clear-concurrency-limit [OPTIONS] NAME
```

> [!NOTE]
>
> Clear any concurrency limits from a work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to clear

> **Options**
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.

## `prefect work-queue pause`

```command theme={null}
prefect work-queue pause [OPTIONS] NAME
```

> [!NOTE]
>
> Pause a work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to pause

> **Options**
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.

## `prefect work-queue resume`

```command theme={null}
prefect work-queue resume [OPTIONS] NAME
```

> [!NOTE]
>
> Resume a paused work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to resume

> **Options**
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.

## `prefect work-queue inspect`

```command theme={null}
prefect work-queue inspect [OPTIONS] NAME
```

> [!NOTE]
>
> Inspect a work queue by ID.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to inspect

> **Options**
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.
>
> **--output**
>
> Specify an output format. Currently supports: json

## `prefect work-queue slots`

```command theme={null}
prefect work-queue slots [OPTIONS] NAME
```

> [!NOTE]
>
> Show concurrency slot utilization for a work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue.

> **Options**
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.
>
> **--output**
>
> Specify an output format. Currently supports: json

## `prefect work-queue ls`

```command theme={null}
prefect work-queue ls [OPTIONS]
```

> [!NOTE]
>
> View all work queues.

> **Options**
>
> **--verbose**
>
> Display more information.
>
> **--match**
>
> Will match work queues with names that start with the specified prefix string
>
> **--pool**
>
> The name of the work pool containing the work queues to list.
>
> **--output**
>
> Specify an output format. Currently supports: json

## `prefect work-queue preview`

```command theme={null}
prefect work-queue preview [OPTIONS] NAME
```

> [!NOTE]
>
> Preview a work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to preview

> **Options**
>
> **--hours**
>
> The number of hours to look ahead; defaults to 1 hour
>
> **--pool**
>
> The name of the work pool that the work queue belongs to.
>
> **--output**
>
> Specify an output format. Currently supports: json

## `prefect work-queue delete`

```command theme={null}
prefect work-queue delete [OPTIONS] NAME
```

> [!NOTE]
>
> Delete a work queue by ID.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to delete

> **Options**
>
> **--pool**
>
> The name of the work pool containing the work queue to delete.

## `prefect work-queue read-runs`

```command theme={null}
prefect work-queue read-runs [OPTIONS] NAME
```

> [!NOTE]
>
> Get runs in a work queue.
>
> Note that this will trigger an artificial poll of the work queue.

> **Arguments**
>
> **NAME** `string` *required*
>
> The name or ID of the work queue to poll

> **Options**
>
> **--pool**
>
> The name of the work pool containing the work queue to poll.