---
title: concurrency_limit
sidebarTitle: concurrency_limit
---

# `prefect.cli.concurrency_limit`



Command line interface for working with concurrency limits.


## Functions

### `create` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/cli/concurrency_limit.py#L30" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python
create(tag: str, concurrency_limit: int)
```


Create a concurrency limit against a tag.

This limit controls how many task runs with that tag may simultaneously be in a
Running state.


### `inspect` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/cli/concurrency_limit.py#L62" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python
inspect(tag: str, output: Optional[str] = typer.Option(None, '--output', '-o', help='Specify an output format. Currently supports: json'))
```


View details about a concurrency limit. `active_slots` shows a list of TaskRun IDs
which are currently using a concurrency slot.


### `ls` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/cli/concurrency_limit.py#L116" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python
ls(limit: int = 15, offset: int = 0)
```


View all concurrency limits.


### `reset` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/cli/concurrency_limit.py#L148" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python
reset(tag: str)
```


Resets the concurrency limit slots set on the specified tag.


### `delete` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/cli/concurrency_limit.py#L163" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python
delete(tag: str)
```


Delete the concurrency limit set on the specified tag.

