---
title: "POST /sys/quotas/rate-limit/{name}"
method: POST
path: "/sys/quotas/rate-limit/{name}"
tags: ["system"]
---

# POST /sys/quotas/rate-limit/{name}

`POST /sys/quotas/rate-limit/{name}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/lensesio/apis/hashicorp-vault-api/docs/sys/quotas/rate-limit/:name/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- SystemQuotasRateLimitRequest
  - `block_interval` integer: If set, when a client reaches a rate limit threshold, the client will be prohibited from any further requests until after the 'block_interval' has elapsed.
  - `interval` integer: The duration to enforce rate limiting for (default '1s').
  - `path` string: Path of the mount or namespace to apply the quota. A blank path configures a global quota. For example namespace1/ adds a quota to a full namespace, namespace1/auth/userpass adds a quota to userpass in namespace1.
  - `rate` number, float: The maximum number of requests in a given interval to be allowed by the quota rule. The 'rate' must be positive.
  - `role` string: Login role to apply this quota to. Note that when set, path must be configured to a valid auth method with a concept of roles.
  - `type` string: Type of the quota rule.

## Response `200`

OK

---

[API](https://skmtc.dev/lensesio/apis/hashicorp-vault-api.md) - [All operations](https://skmtc.dev/lensesio/apis/hashicorp-vault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lensesio/apis/hashicorp-vault-api/revisions/bd8194de0697?raw)