---
title: "Set multiple quotas"
method: POST
path: "/v1/quotas:batchSet"
tags: ["Quotas"]
---

# Set multiple quotas

`POST /v1/quotas:batchSet`

Create or update client throughput quotas for multiple entities in a single request.

## Request body

- BatchSetQuotaRequest
  - `settings` QuotaSetting[] — A list of quota settings to apply. Each setting pairs an entity with the specific values to be set for it.
    - `entity` RequestQuotaEntity
      - `entity_name` string — Entity name is the name of the entity type specified. If left empty, the entity will be treated as a default entity (e.g., all clients). If entity_type is ENTITY_TYPE_CLIENT_ID_PREFIX, this field must be set.
      - `entity_type` 'ENTITY_TYPE_CLIENT_ID' | 'ENTITY_TYPE_CLIENT_ID_PREFIX' | 'ENTITY_TYPE_USER' | 'ENTITY_TYPE_IP' — The type of entity that the quota applies to. - ENTITY_TYPE_USER: Not supported in Redpanda - ENTITY_TYPE_IP: Not supported in Redpanda
    - `values` RequestQuotaValue[]
      - `value` number, double
      - `value_type` 'VALUE_TYPE_PRODUCER_BYTE_RATE' | 'VALUE_TYPE_CONSUMER_BYTE_RATE' | 'VALUE_TYPE_CONTROLLER_MUTATION_RATE' | 'VALUE_TYPE_REQUEST_PERCENTAGE' — The type of value that the quota represents. - VALUE_TYPE_PRODUCER_BYTE_RATE: The rate at which producers can send data. - VALUE_TYPE_CONSUMER_BYTE_RATE: The rate at which consumers can fetch data. - VALUE_TYPE_CONTROLLER_MUTATION_RATE: The rate at which topic mutation requests can be made. - VALUE_TYPE_REQUEST_PERCENTAGE: The percentage of the total throughput that can be used by the entity. Not supported in Redpanda

## Response `201`

Quotas Set

- BatchSetQuotaResponse
  - `failed_entities` FailedEntity[]
    - `entity_name` string
    - `entity_type` 'ENTITY_TYPE_CLIENT_ID' | 'ENTITY_TYPE_CLIENT_ID_PREFIX' | 'ENTITY_TYPE_USER' | 'ENTITY_TYPE_IP' — The type of entity that the quota applies to. - ENTITY_TYPE_USER: Not supported in Redpanda - ENTITY_TYPE_IP: Not supported in Redpanda
    - `error_code` integer
    - `error_message` string
  - `successful_entities` SuccessfulEntity[]
    - `entity_name` string
    - `entity_type` 'ENTITY_TYPE_CLIENT_ID' | 'ENTITY_TYPE_CLIENT_ID_PREFIX' | 'ENTITY_TYPE_USER' | 'ENTITY_TYPE_IP' — The type of entity that the quota applies to. - ENTITY_TYPE_USER: Not supported in Redpanda - ENTITY_TYPE_IP: Not supported in Redpanda

## Other responses

- `401` — Unauthenticated.
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/revisions/7eef0bcc42e7/schema)