Invalid query filters
For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

The filters on a list endpoint could not be parsed, or they reference something that cannot be filtered on.

  • HTTP status — 400 Bad Request
  • type — https://kestra.io/docs/api-reference/problems/invalid-query-filters

When you get it

  • The filters[...] syntax is malformed.
  • The field is one the endpoint does not support filtering on.
  • The operator does not apply to that field’s type.

Example response

A response reporting this problem:

{
  "type": "https://kestra.io/docs/api-reference/problems/invalid-query-filters",
  "title": "Invalid query filters",
  "status": 400,
  "detail": "Unknown filter field 'stat'.",
  "instance": "/api/v1/main/executions/search"
}

How to handle it

Check the field and the operator against the filters the endpoint documents. An unrecognised filter is rejected rather than ignored, so that a query never silently returns unfiltered results.

For the members every problem document carries, see Problem Details.

Was this page helpful?