Apply Filter Conditions

Overview

Run the Apply Filter Conditions action from a handler.

This action is the same as clicking Apply in the Filter Panel. Use it after actions that change filters without auto-apply.

Handlers and actions

• Handler: defines what happens when a user clicks a Kanban UI element.

• Action: an executable operation triggered by the handler.

• Primary action here: Kanban API → Apply Filter Conditions.

• Optional follow-ups: configure extra actions on success or failure.

See Configuring Handlers.

Key concepts

Filter Panel The panel where active filter conditions are displayed and managed. Clicking Apply refreshes the board.

Composite Kanban A parent Kanban with multiple child Kanbans. Use kanbans to target specific children.

Configuration

Configure the handler on the interactive element.

Primary action type Kanban API

Primary action Apply Filter Conditions

Action parameters Optional. Use them only for composite Kanban setups.

Parameters

Name	Description	Required
kanbans	The IDs of the Kanbans to apply conditions to. Accepts a JSON array (e.g., ["kanban_001", "kanban_002"]) or a semicolon-separated string (e.g., "kanban_001;kanban_002"). Only needed for composite Kanbans.	No

kanbans notes

• Use this only in a composite Kanban.

• Use an array or a semicolon-separated string.

Example

{
  "kanbans": ["kanban_001", "kanban_002"]
}

Behavior

When the handler runs the action:

1. Programmatically triggers the Apply action on the Filter Panel, activating the current filter state and refreshing the board.

2. If kanbans is provided, applies conditions only to the specified Kanbans within a composite Kanban setup.

Related actions

• Select Filters Template (loads template into the panel)

• Merge Filters Template (merges template into the panel)

• Clear Filter Conditions (clears the panel)

• Reset Filter Conditions (restores view defaults)

Troubleshooting

The board does not refresh. Confirm the handler is firing. Confirm the chain order is correct.

Conditions apply to all Kanbans. Provide kanbans to target specific child Kanbans.

kanbans targets the wrong Kanbans. Check the IDs. Avoid spaces in the semicolon string.

Filters look correct, but results are wrong. The action applies whatever is in the panel. Review all active filters and orders.