From c15e1ee2c253a4c953cf62f8535246fa227036d7 Mon Sep 17 00:00:00 2001 From: Andres Tobon Date: Thu, 9 Apr 2026 11:35:48 -0700 Subject: [PATCH 1/2] docs: document filters, filters_all, and filters_or query params in README Generated with [Claude Code](https://claude.ai/claude-code) Signed-off-by: Andres Tobon --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index b87202d..e1d118c 100644 --- a/README.md +++ b/README.md @@ -220,6 +220,9 @@ Authorization: Bearer - `parent`: Parent resource for hierarchical queries - `tags`: Array of tags to filter by (OR logic - matches resources with any of these tags) - `tags_all`: Array of tags to filter by (AND logic - matches resources that have all of these tags) +- `filters`: Array of exact field filters with AND logic (format: `field:value`, e.g. `stage:Active`). Fields are auto-prefixed with `data.`. Prefer `filters_all` going forward +- `filters_all`: Same as `filters` — AND logic, all filters must match. Explicit preferred alias +- `filters_or`: Array of exact field filters with OR logic — at least one must match (same `field:value` format) - `cel_filter`: CEL expression for advanced post-query filtering (see [CEL Filter](#cel-filter) section) - `date_field`: Date field to filter on (within data object) - used with date_from and/or date_to - `date_from`: Start date (inclusive). Format: ISO 8601 datetime or date-only (YYYY-MM-DD). Date-only uses start of day UTC From 3b0b297dbdb5eb5cb215d682ec22717617a49372 Mon Sep 17 00:00:00 2001 From: Andres Tobon Date: Thu, 9 Apr 2026 11:38:56 -0700 Subject: [PATCH 2/2] docs: clarify filters vs filters_all relationship in README Generated with [Claude Code](https://claude.ai/claude-code) Signed-off-by: Andres Tobon --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e1d118c..cf3ee9a 100644 --- a/README.md +++ b/README.md @@ -220,8 +220,8 @@ Authorization: Bearer - `parent`: Parent resource for hierarchical queries - `tags`: Array of tags to filter by (OR logic - matches resources with any of these tags) - `tags_all`: Array of tags to filter by (AND logic - matches resources that have all of these tags) -- `filters`: Array of exact field filters with AND logic (format: `field:value`, e.g. `stage:Active`). Fields are auto-prefixed with `data.`. Prefer `filters_all` going forward -- `filters_all`: Same as `filters` — AND logic, all filters must match. Explicit preferred alias +- `filters`: Legacy/backwards-compatible array of exact field filters with AND logic (format: `field:value`, e.g. `stage:Active`). Fields are auto-prefixed with `data.` +- `filters_all`: Preferred array of exact field filters with AND logic (same `field:value` format). If both `filters` and `filters_all` are provided, both sets of filters are applied and combined with AND logic - `filters_or`: Array of exact field filters with OR logic — at least one must match (same `field:value` format) - `cel_filter`: CEL expression for advanced post-query filtering (see [CEL Filter](#cel-filter) section) - `date_field`: Date field to filter on (within data object) - used with date_from and/or date_to