---
title: "Create a rate limit"
method: POST
path: "/v1/mock-apis/{mockApiId}/settings/rateLimits"
tags: ["Settings"]
---

# Create a rate limit

`POST /v1/mock-apis/{mockApiId}/settings/rateLimits`

## Request

- Base URL: `https://wmc.wiremockapi.cloud`
- URL: `https://wmc.wiremockapi.cloud/v1/mock-apis/{mockApiId}/settings/rateLimits`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/wiremock/apis/wiremock-cloud/docs/v1/mock-apis/:mockApiId/settings/rateLimits/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `rateLimit` RateLimitWithId, required: A rate limit configuration with its identifier.
    - `id` string, required: Unique identifier for this rate limit.
    - `rate` integer, required: Number of requests allowed per time unit.
    - `unit` 'seconds' | 'minutes' | 'hours' | 'days', required: Time unit for the rate limit.
    - `burst` integer: Maximum burst capacity. Defaults to the rate value if not specified.

## Response `201`

Rate limit created

- object
  - `rateLimit` RateLimitWithId: A rate limit configuration with its identifier.
    - `id` string, required: Unique identifier for this rate limit.
    - `rate` integer, required: Number of requests allowed per time unit.
    - `unit` 'seconds' | 'minutes' | 'hours' | 'days', required: Time unit for the rate limit.
    - `burst` integer: Maximum burst capacity. Defaults to the rate value if not specified.
  - `links` object
    - `self` string

## Other responses

- `401`: 401 Unauthenticated response
- `403`: 403 Unauthorized response
- `422`: 422 Bad Entity response

---

[API](https://skmtc.dev/wiremock/apis/wiremock-cloud.md) - [All operations](https://skmtc.dev/wiremock/apis/wiremock-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/wiremock/apis/wiremock-cloud/revisions/93bebefc672f?raw)