---
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 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.net/wiremock/apis/wiremock-cloud.md) · [All operations](https://skmtc.net/wiremock/apis/wiremock-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wiremock/wiremock-cloud/revisions/93bebefc672f/schema)