---
title: "Update Refine Filter"
method: PATCH
path: "/refine_filters/{id}"
tags: ["RefineFilter"]
---

# Update Refine Filter

`PATCH /refine_filters/{id}`

Update an existing RefineFilter. All fields are optional — only provided fields are
updated. When `criteria` is supplied it replaces the entire criteria set (must contain
at least one entry). 422 covers shape errors and
[safe-condition policy](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#safe-condition-whitelist) violations.

## Path parameters

- `id` string, required

## Request body

- RefineFilterParametersUpdate — Parameters for updating an existing RefineFilter. All fields are optional — only provided fields are updated. When `criteria` is supplied it **replaces** the entire criteria set. Replacement criteria must satisfy the same safe-condition whitelist enforced on create. See [Safe condition whitelist](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#safe-condition-whitelist) for the full reference.
  - `refine_filter` object, required
    - `name` string — New name for the filter. Must be unique within the workspace.
    - `conjunction` 'and' | 'or' — Replacement join operator for all criteria.
    - `criteria` object[] — Replacement criteria array. Must contain at least one entry.
      - `attribute` string, required
      - `clause` string, required
      - `value` union — Comparison value. Omit for set/not-set clauses.
        - string
        - string[]

## Response `200`

OK

- RefineFilterAttributes — A reusable workspace-scoped audience filter composed of one or more criteria joined by a single conjunction. Public API requests are validated against a [safe-condition whitelist](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#safe-condition-whitelist); criteria outside the whitelist return 422 with a pointer to the developer community.
  - `id` integer — Refine Filter ID
  - `public_id` string — Obfuscated Refine Filter ID
  - `workspace_id` integer — ID of the workspace this filter belongs to
  - `name` string, nullable — Optional human-readable name for the filter. Must be unique within the workspace when set.
  - `filter_class` string — The filter class. Currently always `ContactsFilter`.
  - `conjunction` 'and' | 'or' — How the criteria are joined — `and` (all must match) or `or` (any must match).
  - `criteria` RefineFilterCriterion[] — Ordered list of filter criteria.
    - `attribute` string — The contact attribute to filter on (e.g. `tags.id`, `created_at`, `email_address`). The public API restricts attributes to a [safe whitelist](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#safe-condition-whitelist) — see the [Refine Filters Skill](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md) for the full reference.
    - `clause` string — The comparison operator for this criterion (e.g. `in`, `eq`, `gte`, `lte`, `st`, `nst`). Allowed clauses depend on the attribute. Text attributes (`email_address`, `first_name`, `last_name`) only accept `eq` and `sw` on the public API; see the [Refine Filters Skill](https://accounts.myclickfunnels.com/.well-known/refine-filters/skill.md#safe-condition-whitelist).
    - `value` union — The comparison value. Type depends on the attribute and clause: - **Option conditions** (tags, products, etc.): a single opaque public id string, or an array of public id strings. - **Date/datetime conditions**: an ISO 8601 date string (`"2026-01-01"`) or datetime string (`"2026-01-01T00:00:00Z"`). For `between`/`not_between` clauses supply an array of exactly two date strings. - **Text/numeric conditions**: a plain string or number. - **Set/not-set clauses**: omit `value` entirely.
      - string
      - string[]
  - `created_at` string, date-time — Created at
  - `updated_at` string, date-time — Updated at

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api.md) · [All operations](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myclickfunnels/clickfunnels-api/revisions/ae6313eaa176/schema)