# Throttle an update by query operation

**POST /_update_by_query/{task_id}/_rethrottle**

Change the number of requests per second for a particular update by query operation.
Rethrottling that speeds up the query takes effect immediately but rethrotting that slows down the query takes effect after completing the current batch to prevent scroll timeouts.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **task_id** (string)
  The ID for the task.

### Query parameters
- **requests_per_second** (number)
  The throttle for this request in sub-requests per second.
  To turn off throttling, set it to `-1`.


## Responses
### 200


#### Body: application/json (object)
- **nodes** (object)



[Powered by Bump.sh](https://bump.sh)