---
title: "Create Concurrency Limit V2"
method: POST
path: "/api/v2/concurrency_limits/"
tags: ["Concurrency Limits V2"]
---

# Create Concurrency Limit V2

`POST /api/v2/concurrency_limits/`

## Headers

- `x-prefect-api-version` string

## Request body

- ConcurrencyLimitV2Create — Data used by the Prefect REST API to create a v2 concurrency limit.
  - `active` boolean — Whether the concurrency limit is active.
  - `name` string, required — The name of the concurrency limit.
  - `limit` integer, required — The concurrency limit.
  - `active_slots` integer — The number of active slots.
  - `denied_slots` integer — The number of denied slots.
  - `slot_decay_per_second` number — The decay rate for active slots when used as a rate limit.

## Response `201`

Successful Response

- ConcurrencyLimitV2 — An ORM representation of a v2 concurrency limit.
  - `id` string, uuid
  - `created` string, date-time
  - `updated` string, date-time
  - `active` boolean — Whether the concurrency limit is active.
  - `name` string, required — The name of the concurrency limit.
  - `limit` integer, required — The concurrency limit.
  - `active_slots` integer — The number of active slots.
  - `denied_slots` integer — The number of denied slots.
  - `slot_decay_per_second` number — The decay rate for active slots when used as a rate limit.
  - `avg_slot_occupancy_seconds` number — The average amount of time a slot is occupied.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prefecthq/apis/untitled-api-2.md) · [All operations](https://skmtc.net/prefecthq/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prefecthq/untitled-api-2/revisions/29ba6c4f8837/schema)