# Throttle a delete by query operation

**POST /_delete_by_query/{task_id}/_rethrottle**

Change the number of requests per second for a particular delete 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 disable throttling, set it to `-1`.


## Responses
### 200


#### Body: application/json (object)
- **node_failures** (array[object])

- **task_failures** (array[object])

- **nodes** (object)
  Task information grouped by node, if `group_by` was set to `node` (the default).
- **tasks** (array[object] | object)
  Either a flat list of tasks if `group_by` was set to `none`, or grouped by parents if
  `group_by` was set to `parents`.


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