> ## 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.

# Add filter values

> Adds values to a set filter transform. Duplicates are ignored.

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

Adds values to the filter. Duplicates are ignored. 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", "0xc2132d05d31c914a87c6611c10748aeb04b58e8f"]
}
```

| Field    | Required | Description                                |
| :------- | :------- | :----------------------------------------- |
| `values` | Yes      | Array of string values to add (min 1 item) |

```bash theme={null}
curl -X POST 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}
{ "added": 1 }
```

<Warning>
  Use **lowercase** values when filtering by addresses, labels, or symbols — this is how values are normalized in the system.
</Warning>