> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Replace filter values

> Atomically replaces all values in a set filter transform.

```
PUT /api/v1/beam/{config_id}/transforms/{transform_uid}/filter-values
```

Atomically replaces all values in the filter. An empty list clears the filter entirely. Changes take effect immediately — no redeploy needed.

**Path parameters:**

| Parameter       | Description                     |
| :-------------- | :------------------------------ |
| `config_id`     | Pipeline configuration ID       |
| `transform_uid` | UID of the set filter transform |

**Request body:**

```json theme={null}
{
  "values": ["0x3c499c542cef5e3811e1192ce70d8cc03d5c3359"]
}
```

| Field    | Required | Description                                                                             |
| :------- | :------- | :-------------------------------------------------------------------------------------- |
| `values` | Yes      | Array of string values to replace the entire filter with. Empty list clears the filter. |

```bash theme={null}
curl -X PUT https://api.allium.so/api/v1/beam/${CONFIG_ID}/transforms/${TRANSFORM_UID}/filter-values \
  -H "X-API-Key: ${ALLIUM_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "values": ["0x3c499c542cef5e3811e1192ce70d8cc03d5c3359"] }'
```

**Response:**

```json theme={null}
{ "count": 1 }
```