> For the complete documentation index, see [llms.txt](https://docs.flexikanban.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types.md).

# Kanban API Handler Types

### Overview

Kanban API handler types interact with board-level features — the filter system, the dialpad, the email composer, and the note composer. They are configured as the `type` field in a Handler.

See Handlers for the full Handler model and where handlers are configured.

### Filter System Concepts

Several Kanban API types operate on the board's filter system. Before using them, it helps to understand the two distinct filter layers:

**Filter Panel** — the visible filter state. Users can see, edit, and apply these conditions through the Filter Side Panel. Changes to the Filter Panel do not affect the board until the user clicks Apply, or until an **Apply Filter Conditions** handler fires.

**Hidden conditions** — filter conditions that are not visible in the Filter Panel. They still affect which records are shown on the board. Because users cannot see them, always provide a way for users to clear hidden conditions when you use them.

These two layers are independent. Actions that clear the Filter Panel do not touch hidden conditions, and vice versa.

***

### Filter Action Quick Reference

| Action                            | Target                | Auto-applies              | Replaces or merges     |
| --------------------------------- | --------------------- | ------------------------- | ---------------------- |
| Apply Filters Template            | Filter Panel          | ✅ Yes                     | Replaces all           |
| Apply Filters Template Conditions | Hidden conditions     | ✅ Yes                     | Merges                 |
| Select Filters Template           | Filter Panel          | ❌ No                      | Replaces all           |
| Merge Filters Template            | Filter Panel          | ❌ No                      | Merges                 |
| Add Filter Condition              | Filter Panel          | ❌ No                      | Always appends         |
| Add Labels Filter Condition       | Filter Panel          | ❌ No                      | Adds (deduplicates)    |
| Apply Filter Conditions           | Filter Panel + Hidden | ✅ Yes — this is the apply | —                      |
| Clear Filter Conditions           | Filter Panel          | ❌ No — chain Apply        | Clears all             |
| Reset Filter Conditions           | Filter Panel          | ❌ No — chain Apply        | Restores View defaults |
| Clear Hidden Conditions           | Hidden conditions     | ❌ No — chain Apply        | Clears all             |

***

### Related Articles

* Handlers
* Actions and Action Groups
* Filter Side Panel
* Views


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.