# Update a filter

**POST /_ml/filters/{filter_id}/_update**

Updates the description of a filter, adds items, or removes items from the list.

## Required authorization

* Cluster privileges: `manage_ml`



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


## Authentication methods
- Api key auth


## Parameters

### Path parameters
- **filter_id** (string)
  A string that uniquely identifies a filter.


### Body: application/json (object)

- **add_items** (array[string])
  The items to add to the filter.
- **description** (string)
  A description for the filter.
- **remove_items** (array[string])
  The items to remove from the filter.


## Responses
### 200


#### Body: application/json (object)
- **description** (string)

- **filter_id** (string)

- **items** (array[string])



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