---
title: "Modify an existing rate limiting policy."
method: PUT
path: "/ratelimitingpolicies/{id}"
tags: ["RateLimiting"]
---

# Modify an existing rate limiting policy.

`PUT /ratelimitingpolicies/{id}`

## Path parameters

- `id` string, required

## Request body

- ModifyRateLimitingPolicyCommand
  - `AuditMode` boolean, required — When enabled, the policy logs requests that would be rate limited without rejecting them (no 429 response).
  - `BurstLimit` integer, required — Maximum capacity of the token bucket.
  - `Id` string, required — ID of the policy to modify.
  - `IsEnabled` boolean, required — Whether this policy is actively enforced.
  - `Name` string, required — The display name of the policy.
  - `RequestsPerMinute` integer, required — Number of requests permitted per minute.
  - `ScopeType` string, required — The scope this policy applies to.

## Response `200`

A Rate Limiting Policy

- RateLimitingPolicyResource — A rate limiting policy that controls request throughput using token bucket semantics.
  - `AuditMode` boolean, required — When enabled, the policy logs requests that would be rate limited without rejecting them (no 429 response).
  - `BurstLimit` integer, required — Maximum capacity of the token bucket.
  - `Id` string, required — The ID of this policy.
  - `IsBuiltIn` boolean, required — Whether this is a built-in policy that cannot be deleted or have its name or scope changed.
  - `IsEnabled` boolean, required — Whether this policy is actively enforced.
  - `Name` string, required — The display name of this policy.
  - `RequestsPerMinute` integer, required — Number of requests permitted per minute.
  - `ScopeType` string, required — The scope this policy applies to.

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/revisions/b296c3a60aa5/schema)