---
title: fastly service rate-limit update
summary: Update a rate limiter by its ID
url: https://www.fastly.com/documentation/reference/cli/service/rate-limit/update
---

Update a rate limiter by its ID

## Flags

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--id` | Alphanumeric string identifying the rate limiter | Yes | - |
| `--action` | The action to take when a rate limiter violation is detected | No | - |
| `--client-key` | Comma-separated list of VCL variable used to generate a counter key to identify a client | No | - |
| `--feature-revision` | Revision number of the rate limiting feature implementation | No | - |
| `--http-methods` | Comma-separated list of HTTP methods to apply rate limiting to | No | - |
| `--json` | Render output as JSON | No | - |
| `--logger-type` | Name of the type of logging endpoint to be used when action is `log_only` | No | - |
| `--name` | A human readable name for the rate limiting rule | No | - |
| `--penalty-box-dur` | Length of time in minutes that the rate limiter is in effect after the initial violation is detected | No | - |
| `--response-content` | HTTP response body data | No | - |
| `--response-content-type` | HTTP Content-Type (e.g. application/json) | No | - |
| `--response-object-name` | Name of existing response object. Required if action is response_object | No | - |
| `--response-status` | HTTP response status code (e.g. 429) | No | - |
| `--rps-limit` | Upper limit of requests per second allowed by the rate limiter | No | - |
| `--uri-dict-name` | The name of an Edge Dictionary containing URIs as keys | No | - |
| `--window-size` | Number of seconds during which the RPS limit must be exceeded in order to trigger a violation | No | - |

## Global options

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--help` | Show context-sensitive help. | No | - |
| `--accept-defaults` | Accept default options for all interactive prompts apart from Yes/No confirmations | No | - |
| `--auto-yes` | Answer yes automatically to all Yes/No confirmations. This may suppress security warnings | No | - |
| `--debug-mode` | Print API request and response details (NOTE: can disrupt the normal CLI flow output formatting) | No | - |
| `--non-interactive` | Do not prompt for user input - suitable for CI processes. Equivalent to --accept-defaults and --auto-yes | No | - |
| `--quiet` | Silence all output except direct command output. This won't prevent interactive prompts (see: --accept-defaults, --auto-yes, --non-interactive) | No | - |
| `--token` | Fastly API token, or name of a stored auth token (use 'default' for the default token). Falls back to FASTLY_API_TOKEN env var | No | - |
| `--verbose` | Verbose logging | No | - |